Realiza la detección de rostro en las imágenes.
La API espera un modelo de TFLite con los metadatos del modelo de TFLite.
- Imagen de entrada
MPImage- La imagen en la que se ejecuta el detector de rostros.
- Salida FaceDetectorResult
FaceDetectorResult- Un FaceDetectorResult que contiene rostros detectados.
Categorías anidadas
| clase | FaceDetector.FaceDetectorOptions | Opciones para configurar un FaceDetector. |
|
Métodos públicos
| estático FaceDetector |
createFromBuffer(contexto de contexto, modelBuffer de ByteBuffer)
Crea una instancia
FaceDetector a partir de un búfer de modelo y el FaceDetector.FaceDetectorOptions predeterminado. |
| estático FaceDetector |
createFromFile(contexto de contexto, String modelPath)
Crea una instancia de
FaceDetector a partir de un archivo de modelo y el FaceDetector.FaceDetectorOptions predeterminado. |
| estático FaceDetector |
createFromFile(contexto de contexto, Archivo modelFile)
Crea una instancia de
FaceDetector a partir de un archivo de modelo y el FaceDetector.FaceDetectorOptions predeterminado. |
| estático FaceDetector |
createFromOptions(contexto de contexto, FaceDetector.FaceDetectorOptions detectorOptions)
Crea una instancia de
FaceDetector a partir de un FaceDetector.FaceDetectorOptions. |
| FaceDetectorResult | |
| FaceDetectorResult |
detect(imagen MPImage, ImageProcessingOptions imageProcessingOptions)
Realiza la detección de rostro 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 rostro, y los resultados estarán disponibles a través del
OutputHandler.ResultListener proporcionado en FaceDetector.FaceDetectorOptions. |
| void |
detectAsync(imagen MPImage, timestampMs largo)
Envía datos de imágenes en vivo para realizar la detección de rostro con las opciones de procesamiento de imágenes predeterminadas, p.ej.,
|
| FaceDetectorResult |
detectForVideo(imagen MPImage, ImageProcessingOptions imageProcessingOptions, marca de tiempo largaMs)
Realiza la detección de rostro en el fotograma del video proporcionado.
|
| FaceDetectorResult |
detectForVideo(imagen MPImage, timestampMs largo)
Realiza la detección de rostro en el fotograma del video proporcionado con opciones de procesamiento de imagen predeterminadas, p.ej.,
|
Métodos heredados
Métodos públicos
público estático FaceDetector createFromBuffer (contexto de contexto, ByteBuffer modelBuffer)
Crea una instancia FaceDetector a partir de un búfer de modelo y el FaceDetector.FaceDetectorOptions predeterminado.
Parámetros
| Contexto | un ERROR(/Context) de Android |
|---|---|
| modelBuffer | un ByteBuffer directo o un ERROR(/MappedByteBuffer) del modelo de detección. |
Arroja
Si se produce un error durante la creación de FaceDetector.
|
publica estática estática FaceDetector createFromFile (contexto de contexto, String modelPath)
Crea una instancia de FaceDetector a partir de un archivo de modelo y el FaceDetector.FaceDetectorOptions predeterminado.
Parámetros
| Contexto | un ERROR(/Context) de Android |
|---|---|
| modelPath | al modelo de detección con metadatos en los recursos. |
Arroja
Si se produce un error durante la creación de FaceDetector.
|
estático público FaceDetector createFromFile (Contexto del contexto, Archivo modelFile)
Crea una instancia de FaceDetector a partir de un archivo de modelo y el FaceDetector.FaceDetectorOptions predeterminado.
Parámetros
| Contexto | un ERROR(/Context) de Android |
|---|---|
| modelFile | a la instancia del modelo de detección File. |
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 FaceDetector.
|
estático público FaceDetector createFromOptions (Contexto de contexto, FaceDetector.FaceDetectorOptions detectorOptions)
Crea una instancia de FaceDetector a partir de un FaceDetector.FaceDetectorOptions.
Parámetros
| Contexto | un ERROR(/Context) de Android |
|---|---|
| detectorOptions | una instancia de FaceDetector.FaceDetectorOptions. |
Arroja
Si se produce un error durante la creación de FaceDetector.
|
public FaceDetectorResult detect (MPImage image)
Realiza la detección de rostro en la imagen única proporcionada con las opciones de procesamiento de imagen predeterminadas,
es decir, sin aplicar ninguna rotación. Usa este método solo cuando se cree el FaceDetector con ERROR(/RunningMode.IMAGE).
FaceDetector 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. |
public FaceDetectorResult detect (MPImage imagen, ImageProcessingOptions imageProcessingOptions)
Realiza la detección de rostro en la imagen única proporcionada. Usa este método solo cuando se cree el FaceDetector con ERROR(/RunningMode.IMAGE).
FaceDetector 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 rostro, y los resultados estarán disponibles a través del OutputHandler.ResultListener proporcionado en FaceDetector.FaceDetectorOptions. Usa este método solo cuando
se cree el FaceDetector 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 detector de rostros. Las marcas de tiempo de entrada deben aumentar monótonamente.
FaceDetector 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 rostro con las 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 FaceDetector.FaceDetectorOptions. Usa este método solo cuando se cree el objeto FaceDetector 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 detector de rostros. Las marcas de tiempo de entrada deben aumentar monótonamente.
FaceDetector 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 FaceDetectorResult detectForVideo (MPImage imagen, ImageProcessingOptions imageProcessingOptions, long timestampMs)
Realiza la detección de rostro en el fotograma del video proporcionado. Usa este método solo cuando se cree el FaceDetector 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.
FaceDetector 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 FaceDetectorResult detectForVideo (MPImage imagen, timestampMs long)
Realiza la detección de rostro en el fotograma de video proporcionado con opciones de procesamiento de imágenes predeterminadas (es decir, sin rotación). Usa este método solo cuando se cree el FaceDetector 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.
FaceDetector 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. |