FaceDetector

classe final pública FaceDetector

Executa detecção facial em imagens.

A API espera um modelo do TFLite com TFLite Model Metadata..

  • Imagem de entrada MPImage
    • A imagem em que o detector facial é executado.
  • FaceDetectorResult de saída FaceDetectorResult
    • Um FaceDetectorResult contendo os rostos detectados.

Classes aninhadas

classe FaceDetector.FaceDetectorOptions Opções para configurar um FaceDetector. 

Métodos públicos

estático FaceDetector
createFromBuffer(contexto de contexto, modelBuffer ByteBuffer)
Cria uma instância FaceDetector com base em um buffer de modelo e o FaceDetector.FaceDetectorOptions padrão.
estático FaceDetector
createFromFile(contexto de contexto, modelPath String)
Cria uma instância FaceDetector com base em um arquivo de modelo e o FaceDetector.FaceDetectorOptions padrão.
estático FaceDetector
createFromFile(contexto de contexto, File modelFile)
Cria uma instância FaceDetector com base em um arquivo de modelo e o FaceDetector.FaceDetectorOptions padrão.
estático FaceDetector
createFromOptions(contexto de contexto, FaceDetector.FaceDetectorOptions detectorOptions)
Cria uma instância de FaceDetector de um FaceDetector.FaceDetectorOptions.
FaceDetectorResult
detect(imagem MPImage)
Executa detecção facial na única imagem fornecida com opções de processamento de imagem padrão, ou seja,
FaceDetectorResult
detect(imagem MPImage, ImageProcessingOptions imageprocessingOptions)
Executa detecção facial na única imagem fornecida.
void
detectAsync(imagem MPImage, ImageProcessingOptions imageHandlingOptions, carimbos de data/hora longos)
Envia dados de imagens em tempo real para realizar a detecção facial, e os resultados ficam disponíveis pelo OutputHandler.ResultListener fornecido no FaceDetector.FaceDetectorOptions.
void
detectAsync(imagem MPImage, carimbos de data/hora longos)
Envia dados de imagens em tempo real para realizar detecção facial com as opções de processamento de imagem padrão, ou seja,
FaceDetectorResult
detectForVideo(imagem MPImage, ImageProcessingOptions imageprocessingOptions, carimbos de data/hora longos)
Executa a detecção facial no frame de vídeo fornecido.
FaceDetectorResult
detectForVideo(imagem MPImage, carimbos de data/hora longos)
Executa detecção facial no frame de vídeo fornecido com opções de processamento de imagem padrão, ou seja,

Métodos herdados

Métodos públicos

público estático FaceDetector createFromBuffer (contexto de contexto, ByteBuffer modelBuffer)

Cria uma instância FaceDetector com base em um buffer de modelo e o FaceDetector.FaceDetectorOptions padrão.

Parâmetros
contexto um ERROR(/Context) do Android.
modelBuffer um ByteBuffer direto ou um ERROR(/MappedByteBuffer) do modelo de detecção.
Gera
se houver um erro durante a criação de FaceDetector.

public estático FaceDetector createFromFile (contexto de contexto, String modelPath)

Cria uma instância FaceDetector com base em um arquivo de modelo e o FaceDetector.FaceDetectorOptions padrão.

Parâmetros
contexto um ERROR(/Context) do Android.
modelPath caminho para o modelo de detecção com metadados nos recursos.
Gera
se houver um erro durante a criação de FaceDetector.

público estático FaceDetector createFromFile (contexto de contexto, arquivo modelFile)

Cria uma instância FaceDetector com base em um arquivo de modelo e o FaceDetector.FaceDetectorOptions padrão.

Parâmetros
contexto um ERROR(/Context) do Android.
modelFile a instância File do modelo de detecção.
Gera
IOException se ocorrer um erro de E/S ao abrir o arquivo do modelo do tflite.
se houver um erro durante a criação de FaceDetector.

public Static FaceDetector createFromOptions (contexto de contexto, FaceDetector.FaceDetectorOptions detectorOptions)

Cria uma instância de FaceDetector de um FaceDetector.FaceDetectorOptions.

Parâmetros
contexto um ERROR(/Context) do Android.
detectorOptions uma instância FaceDetector.FaceDetectorOptions.
Gera
se houver um erro durante a criação de FaceDetector.

public FaceDetectorResult detect (MPImage)

Executa detecção facial na única imagem fornecida com opções de processamento de imagem padrão, ou seja, sem aplicação de rotação. Use esse método somente quando o FaceDetector for criado com ERROR(/RunningMode.IMAGE).

FaceDetector oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
Gera
caso haja um erro interno.

public FaceDetectorResult detect (MPImage, ImageProcessingOptions imageprocessingOptions)

Executa detecção facial na única imagem fornecida. Use esse método somente quando o FaceDetector for criado com ERROR(/RunningMode.IMAGE).

FaceDetector oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
imageProcessingOptions o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException.
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno.

public void detectAsync (MPImage imagem, ImageProcessingOptions image ProcessingOptions, long timestampMs)

Envia dados de imagens em tempo real para realizar a detecção facial, e os resultados ficam disponíveis pelo OutputHandler.ResultListener fornecido no FaceDetector.FaceDetectorOptions. Use esse método somente quando a FaceDetector for criada com ERROR(/RunningMode.LIVE_STREAM).

É necessário informar um carimbo de data/hora (em milissegundos) para indicar quando a imagem de entrada é enviada ao detector facial. Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

FaceDetector oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
imageProcessingOptions o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno.

public void detectAsync (MPImage imagem, carimbos de data/hora longos)

Envia dados de imagens em tempo real para realizar detecção facial com opções de processamento de imagens padrão, ou seja, sem nenhuma rotação aplicada, e os resultados ficam disponíveis pelo OutputHandler.ResultListener fornecido no FaceDetector.FaceDetectorOptions. Use esse método somente quando o FaceDetector for criado com ERROR(/RunningMode.LIVE_STREAM).

É necessário informar um carimbo de data/hora (em milissegundos) para indicar quando a imagem de entrada é enviada ao detector facial. Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

FaceDetector oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
caso haja um erro interno.

public FaceDetectorResult detectForVideo (imagem MPImage, ImageProcessingOptions imageHandlingOptions, carimbo de data/hora longo)

Executa a detecção facial no frame de vídeo fornecido. Use esse método somente quando o FaceDetector for criado com ERROR(/RunningMode.VIDEO).

É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

FaceDetector oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
imageProcessingOptions o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno.

public FaceDetectorResult detectForVideo (MPImage, carimbo de data/hora longo)

Executa detecção facial no frame de vídeo fornecido com opções de processamento de imagem padrão, ou seja, sem aplicação de rotação. Use esse método somente quando o FaceDetector for criado com ERROR(/RunningMode.VIDEO).

É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

FaceDetector oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
caso haja um erro interno.