Realiza la detección de puntos de referencia faciales en las imágenes.
Esta API espera un paquete de recursos de modelo de puntos de referencia de rostros previamente entrenado. Consulta
- Imagen de entrada
MPImage
- La imagen en la que se ejecuta la detección de puntos de referencia de rostros.
- Salida
FaceLandmarkerResult
- Un FaceLandmarkerResult que contiene puntos de referencia de rostros.
Categorías anidadas
clase | FaceLandmarker.FaceLandmarkerOptions | Opciones para configurar un FaceLandmarker . |
Campos
público estático final Set<Connection> | FACE_LANDMARKS_CONNECTORS | |
público estático final Set<Connection> | FACE_LANDMARKS_FACE_OVAL | |
público estático final Set<Connection> | FACE_LANDMARKS_LEFT_EYE | |
público estático final Set<Connection> | FACE_LANDMARKS_LEFT_EYE_BROW | |
público estático final Set<Connection> | FACE_LANDMARKS_LEFT_IRIS | |
público estático final Set<Connection> | FACE_LANDMARKS_LIPS | |
público estático final Set<Connection> | FACE_LANDMARKS_RIGHT_EYE | |
público estático final Set<Connection> | FACE_LANDMARKS_RIGHT_EYE_BROW | |
público estático final Set<Connection> | FACE_LANDMARKS_RIGHT_IRIS | |
público estático final Set<Connection> | FACE_LANDMARKS_TESSELATION |
Métodos públicos
estático FaceLandmarker |
createFromBuffer(contexto de contexto, modelAssetBuffer de ByteBuffer)
Crea una instancia
FaceLandmarker a partir de un búfer de paquete de recursos de modelo y el FaceLandmarker.FaceLandmarkerOptions predeterminado. |
estático FaceLandmarker |
createFromFile(contexto de contexto, String modelAssetPath)
Crea una instancia
FaceLandmarker a partir de la ruta de un paquete de recursos del modelo y el FaceLandmarker.FaceLandmarkerOptions predeterminado. |
estático FaceLandmarker |
createFromFile(contexto de contexto, archivo modelAssetFile)
Crea una instancia
FaceLandmarker a partir de un archivo de paquete de recursos del modelo y el FaceLandmarker.FaceLandmarkerOptions predeterminado. |
estático FaceLandmarker |
createFromOptions(contexto de contexto, FaceLandmarker.FaceLandmarkerOptions puntos de referencia de)
Crea una instancia de
FaceLandmarker a partir de un FaceLandmarker.FaceLandmarkerOptions . |
FaceLandmarkerResult | |
FaceLandmarkerResult |
detect(imagen MPImage, ImageProcessingOptions imageProcessingOptions)
Realiza la detección de puntos de referencia faciales en la imagen única proporcionada.
|
void |
detectAsync(imagen MPImage, ImageProcessingOptions imageProcessingOptions, marca de tiempo largaMs)
Envía datos de imágenes en vivo para realizar la detección de puntos de referencia faciales, y los resultados estarán disponibles a través del
OutputHandler.ResultListener proporcionado en FaceLandmarker.FaceLandmarkerOptions . |
void |
detectAsync(imagen MPImage, timestampMs largo)
Envía datos de imágenes en vivo para realizar la detección de puntos de referencia faciales con las opciones de procesamiento de imágenes predeterminadas, p.ej.,
|
FaceLandmarkerResult |
detectForVideo(imagen MPImage, ImageProcessingOptions imageProcessingOptions, marca de tiempo largaMs)
Realiza la detección de puntos de referencia faciales en el fotograma de video proporcionado.
|
FaceLandmarkerResult |
detectForVideo(imagen MPImage, timestampMs largo)
Realiza la detección de puntos de referencia faciales en el fotograma de video proporcionado con las opciones de procesamiento de imágenes predeterminadas, es decir,
|
Métodos heredados
Campos
Métodos públicos
publica estática estática FaceLandmarker createFromBuffer (contexto de contexto, ByteBuffer modelAssetBuffer)
Crea una instancia FaceLandmarker
a partir de un búfer de paquete de recursos de modelo y el FaceLandmarker.FaceLandmarkerOptions
predeterminado.
Parámetros
Contexto | un ERROR(/Context) de Android |
---|---|
modelAssetBuffer |
Arroja
Si se produce un error durante la creación de FaceLandmarker .
|
estático público FaceLandmarker createFromFile (contexto de contexto, String modelAssetPath)
Crea una instancia FaceLandmarker
a partir de la ruta de un paquete de recursos del modelo y el FaceLandmarker.FaceLandmarkerOptions
predeterminado.
Parámetros
Contexto | un ERROR(/Context) de Android |
---|---|
modelAssetPath | ruta de acceso al modelo de puntos de referencia de rostros con metadatos en los recursos. |
Arroja
Si se produce un error durante la creación de FaceLandmarker .
|
estático público FaceLandmarker createFromFile (contexto de contexto, archivo modelAssetFile)
Crea una instancia FaceLandmarker
a partir de un archivo de paquete de recursos del modelo y el FaceLandmarker.FaceLandmarkerOptions
predeterminado.
Parámetros
Contexto | un ERROR(/Context) de Android |
---|---|
modelAssetFile | la instancia File del modelo de puntos de referencia de rostros. |
Arroja
IOException | si se produce un error de E/S cuando se abre el archivo del modelo de tflite. |
---|---|
Si se produce un error durante la creación de FaceLandmarker .
|
público estático FaceLandmarker createFromOptions (contexto de contexto, FaceLandmarker.FaceLandmarkerOptions puntos de referencia de opciones)
Crea una instancia de FaceLandmarker
a partir de un FaceLandmarker.FaceLandmarkerOptions
.
Parámetros
Contexto | un ERROR(/Context) de Android |
---|---|
landmarkerOptions | una instancia de FaceLandmarker.FaceLandmarkerOptions . |
Arroja
Si se produce un error durante la creación de FaceLandmarker .
|
public FaceLandmarkerResult detect (imagen de MPImage)
Realiza la detección de puntos de referencia facial en la imagen única proporcionada con las opciones de procesamiento de imagen predeterminadas, es decir, sin ninguna rotación. Usa este método solo cuando se cree el FaceLandmarker
con ERROR(/RunningMode.IMAGE)
. TODO update java doc para el formato de imagen de entrada.
FaceLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|
Arroja
si se produce un error interno. |
público FaceLandmarkerResult detect (MPImage imagen, ImageProcessingOptions imageProcessingOptions)
Realiza la detección de puntos de referencia faciales en la imagen única proporcionada. Usa este método solo cuando
se cree el FaceLandmarker
con ERROR(/RunningMode.IMAGE)
. TODO update java doc para el formato de imagen de entrada.
FaceLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|---|
imageProcessingOptions | ImageProcessingOptions que especifica cómo procesar la imagen de entrada antes de ejecutar la inferencia. Ten en cuenta que la región de interés no es compatible con esta tarea: especificar ImageProcessingOptions.regionOfInterest() hará que este método arroje una IllegalArgumentException. |
Arroja
IllegalArgumentException | si ImageProcessingOptions especifica una región de interés. |
---|---|
si se produce un error interno. |
public void detectAsync (imagen MPImage, ImageProcessingOptions imageProcessingOptions, long timestampMs)
Envía datos de imágenes en vivo para realizar la detección de puntos de referencia faciales, y los resultados estarán disponibles a través del OutputHandler.ResultListener
proporcionado en FaceLandmarker.FaceLandmarkerOptions
. Usa este método solo cuando se cree el FaceLandmarker
con ERROR(/RunningMode.LIVE_STREAM)
.
Se debe proporcionar una marca de tiempo (en milisegundos) para indicar cuándo se envía la imagen de entrada al punto de referencia facial. Las marcas de tiempo de entrada deben aumentar monótonamente.
FaceLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|---|
imageProcessingOptions | ImageProcessingOptions que especifica cómo procesar la imagen de entrada antes de ejecutar la inferencia. Ten en cuenta que la región de interés no es compatible con esta tarea: especificar ImageProcessingOptions.regionOfInterest() hará que este método arroje una IllegalArgumentException. |
timestampMs | la marca de tiempo de entrada (en milisegundos). |
Arroja
IllegalArgumentException | si ImageProcessingOptions especifica una región de interés. |
---|---|
si se produce un error interno. |
public void detectAsync (imagen MPImage, timestampMs largo)
Envía datos de imágenes en vivo para realizar la detección de puntos de referencia facial con opciones de procesamiento de imagen predeterminadas (es decir, sin rotación), y los resultados estarán disponibles a través del OutputHandler.ResultListener
proporcionado en FaceLandmarker.FaceLandmarkerOptions
. Usa este método solo cuando
se cree el FaceLandmarker
con ERROR(/RunningMode.LIVE_STREAM)
.
Se debe proporcionar una marca de tiempo (en milisegundos) para indicar cuándo se envía la imagen de entrada al punto de referencia facial. Las marcas de tiempo de entrada deben aumentar monótonamente.
FaceLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|---|
timestampMs | la marca de tiempo de entrada (en milisegundos). |
Arroja
si se produce un error interno. |
público FaceLandmarkerResult detectForVideo (MPImage imagen, ImageProcessingOptions imageProcessingOptions, long timestampMs)
Realiza la detección de puntos de referencia faciales en el fotograma de video proporcionado. Usa este método solo cuando
se cree el FaceLandmarker
con ERROR(/RunningMode.VIDEO)
.
Es obligatorio proporcionar la marca de tiempo del fotograma del video (en milisegundos). Las marcas de tiempo de entrada deben aumentar de forma monótona.
FaceLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|---|
imageProcessingOptions | ImageProcessingOptions que especifica cómo procesar la imagen de entrada antes de ejecutar la inferencia. Ten en cuenta que la región de interés no es compatible con esta tarea: especificar ImageProcessingOptions.regionOfInterest() hará que este método arroje una IllegalArgumentException. |
timestampMs | la marca de tiempo de entrada (en milisegundos). |
Arroja
IllegalArgumentException | si ImageProcessingOptions especifica una región de interés. |
---|---|
si se produce un error interno. |
público FaceLandmarkerResult detectForVideo (MPImage imagen, timestampMs largo)
Realiza la detección de puntos de referencia faciales en el fotograma de video proporcionado con las opciones de procesamiento de imágenes predeterminadas (es decir, sin aplicar ninguna rotación). Usa este método solo cuando se cree el FaceLandmarker
con ERROR(/RunningMode.VIDEO)
.
Es obligatorio proporcionar la marca de tiempo del fotograma del video (en milisegundos). Las marcas de tiempo de entrada deben aumentar de forma monótona.
FaceLandmarker
admite los siguientes tipos de espacios de color:
Parámetros
imagen | un objeto MPImage de MediaPipe para su procesamiento |
---|---|
timestampMs | la marca de tiempo de entrada (en milisegundos). |
Arroja
si se produce un error interno. |