FaceDetector

classe pubblica finale FaceDetector

Esegue il rilevamento dei volti sulle immagini.

L'API prevede un modello TFLite con metadati di modelli TFLite.

  • Immagine di input MPImage
    • L'immagine su cui viene eseguito il rilevatore di volti.
  • Output FaceDetectorResult FaceDetectorResult
    • Un FaceDetectorResult contenente i volti rilevati.

Corsi nidificati

classe FaceDetector.FaceDetectorOptions Opzioni per configurare un FaceDetector. 

Metodi pubblici

statico FaceDetector
createFromBuffer(Context context, ByteBuffer modelBuffer)
Crea un'istanza FaceDetector da un buffer del modello e il valore predefinito FaceDetector.FaceDetectorOptions.
statico FaceDetector
createFromFile(Contesto del contesto, Stringa modelPath)
Crea un'istanza FaceDetector da un file del modello e dal valore predefinito FaceDetector.FaceDetectorOptions.
statico FaceDetector
createFromFile(Contesto del contesto, File modelFile)
Crea un'istanza FaceDetector da un file del modello e dal valore predefinito FaceDetector.FaceDetectorOptions.
statico FaceDetector
createFromOptions(Contesto del contesto, FaceDetector.FaceDetectorOptions detectorOptions)
Crea un'istanza FaceDetector da un FaceDetector.FaceDetectorOptions.
FaceDetectorResult
detect(immagine MPImage)
Esegue il rilevamento dei volti sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ad esempio
FaceDetectorResult
detect(MPImage immagine, ImageProcessingOptions imageElaborazioneOptions)
Esegue il rilevamento dei volti sulla singola immagine fornita.
void
detectAsync(MPImage immagine, ImageProcessingOptions image elaborazioneOptions, timestamp lunghiMs)
Invia i dati delle immagini in tempo reale per il rilevamento dei volti e i risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in FaceDetector.FaceDetectorOptions.
void
detectAsync(immagine MPImage, timestamp lunghiM)
Invia i dati delle immagini in tempo reale per il rilevamento dei volti con opzioni di elaborazione delle immagini predefinite, ad esempio
FaceDetectorResult
detectForVideo(MPImage immagine, ImageProcessingOptions imageElaborazioneOptions, timestamp lunghiMs)
Esegue il rilevamento dei volti sul fotogramma video fornito.
FaceDetectorResult
detectForVideo(immagine MPImage, timestamp lunghiM)
Esegue il rilevamento dei volti sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ad esempio

Metodi ereditati

Metodi pubblici

pubblico statico FaceDetector createFromBuffer (Context context, ByteBuffer modelBuffer)

Crea un'istanza FaceDetector da un buffer del modello e il valore predefinito FaceDetector.FaceDetectorOptions.

Parametri
context un ERROR(/Context) Android.
modelBuffer un ByteBuffer diretto o un ERROR(/MappedByteBuffer) del modello di rilevamento.
Lanci
in caso di errore durante la creazione di FaceDetector.

pubblico static FaceDetector createFromFile (Contesto del contesto, Stringa modelPath)

Crea un'istanza FaceDetector da un file del modello e dal valore predefinito FaceDetector.FaceDetectorOptions.

Parametri
context un ERROR(/Context) Android.
modelPath percorso del modello di rilevamento con metadati negli asset.
Lanci
in caso di errore durante la creazione di FaceDetector.

pubblico statico FaceDetector createFromFile (Contesto del contesto, File modelFile)

Crea un'istanza FaceDetector da un file del modello e dal valore predefinito FaceDetector.FaceDetectorOptions.

Parametri
context un ERROR(/Context) Android.
modelFile l'istanza del modello di rilevamento File.
Lanci
IOException se si verifica un errore I/O all'apertura del file del modello tflite.
in caso di errore durante la creazione di FaceDetector.

pubblico static FaceDetector createFromOptions (Context context, FaceDetector.FaceDetectorOptions detectorOptions)

Crea un'istanza FaceDetector da un FaceDetector.FaceDetectorOptions.

Parametri
context un ERROR(/Context) Android.
detectorOptions un'istanza FaceDetector.FaceDetectorOptions.
Lanci
in caso di errore durante la creazione di FaceDetector.

Public FaceDetectorResult detect (MPImage immagine)

Esegue il rilevamento dei volti sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. Utilizza questo metodo solo quando FaceDetector viene creato con ERROR(/RunningMode.IMAGE).

FaceDetector supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
Lanci
in caso di errore interno.

pubblici FaceDetectorResult detect (MPImage immagine, ImageProcessingOptions imageElaborazioneOptions)

Esegue il rilevamento dei volti sulla singola immagine fornita. Utilizza questo metodo solo quando FaceDetector viene creato con ERROR(/RunningMode.IMAGE).

FaceDetector supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
imageProcessingOptions ImageProcessingOptions che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi ImageProcessingOptions.regionOfInterest(), questo metodo genererà un'eccezione di IllegalArgumentException.
Lanci
IllegalArgumentException se ImageProcessingOptions specifica una regione di interesse.
in caso di errore interno.

Public void detectAsync (immagine MPImage, ImageProcessingOptions imageElaborazioneOptions, timestamp lunghiMs)

Invia i dati delle immagini in tempo reale per il rilevamento dei volti e i risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in FaceDetector.FaceDetectorOptions. Utilizza questo metodo solo quando FaceDetector viene creato con ERROR(/RunningMode.LIVE_STREAM).

È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata al rilevatore di volti. I timestamp di input devono essere crescenti in modo monotonico.

FaceDetector supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
imageProcessingOptions ImageProcessingOptions che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi ImageProcessingOptions.regionOfInterest(), questo metodo genererà un'eccezione di IllegalArgumentException.
timestampMs il timestamp di input (in millisecondi).
Lanci
IllegalArgumentException se ImageProcessingOptions specifica una regione di interesse.
in caso di errore interno.

Public void detectAsync (immagine MPImage, timestamp lunghiM)

Invia i dati delle immagini in tempo reale per il rilevamento dei volti con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata, e i risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in FaceDetector.FaceDetectorOptions. Utilizza questo metodo solo quando FaceDetector viene creato con ERROR(/RunningMode.LIVE_STREAM).

È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata al rilevatore di volti. I timestamp di input devono essere crescenti in modo monotonico.

FaceDetector supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
timestampMs il timestamp di input (in millisecondi).
Lanci
in caso di errore interno.

pubblici FaceDetectorResult detectForVideo (MPImage immagine, ImageProcessingOptions imageElaborazioneOptions, data/ora Ms lunghi)

Esegue il rilevamento dei volti sul fotogramma video fornito. Utilizza questo metodo solo quando FaceDetector viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

FaceDetector supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
imageProcessingOptions ImageProcessingOptions che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi ImageProcessingOptions.regionOfInterest(), questo metodo genererà un'eccezione di IllegalArgumentException.
timestampMs il timestamp di input (in millisecondi).
Lanci
IllegalArgumentException se ImageProcessingOptions specifica una regione di interesse.
in caso di errore interno.

Public FaceDetectorResult detectForVideo (immagine MPImage, timestamp lungoMs)

Esegue il rilevamento dei volti sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ovvero senza applicazione di rotazione. Utilizza questo metodo solo quando FaceDetector viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

FaceDetector supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
timestampMs il timestamp di input (in millisecondi).
Lanci
in caso di errore interno.