Esegue il rilevamento dei punti di riferimento dei volti sulle immagini.
Questa API prevede un bundle di asset del modello di punti di riferimento del volto preaddestrato. Vedere la sezione
- Immagine di input
MPImage
- L'immagine su cui viene eseguita il rilevamento dei punti di riferimento.
- Output
FaceLandmarkerResult
- Un FaceLandMarkResult che contiene i punti di riferimento per i volti.
Corsi nidificati
classe | FaceLandmarker.FaceLandmarkerOptions | Opzioni per configurare un FaceLandmarker . |
Campi
pubblico statico finale Set<Connection> | FACE_LANDMARKS_CONNECTORS | |
pubblico statico finale Set<Connection> | FACE_LANDMARKS_FACE_OVAL | |
pubblico statico finale Set<Connection> | FACE_LANDMARKS_LEFT_EYE | |
pubblico statico finale Set<Connection> | FACE_LANDMARKS_LEFT_EYE_BROW | |
pubblico statico finale Set<Connection> | FACE_LANDMARKS_LEFT_IRIS | |
pubblico statico finale Set<Connection> | FACE_LANDMARKS_LIPS | |
pubblico statico finale Set<Connection> | FACE_LANDMARKS_RIGHT_EYE | |
pubblico statico finale Set<Connection> | FACE_LANDMARKS_RIGHT_EYE_BROW | |
pubblico statico finale Set<Connection> | FACE_LANDMARKS_RIGHT_IRIS | |
pubblico statico finale Set<Connection> | FACE_LANDMARKS_TESSELATION |
Metodi pubblici
statico FaceLandmarker |
createFromBuffer(Context context, ByteBuffer modelAssetBuffer)
Crea un'istanza
FaceLandmarker da un buffer del bundle di asset modello e dal valore predefinito FaceLandmarker.FaceLandmarkerOptions . |
statico FaceLandmarker |
createFromFile(Contesto del contesto, Stringa modelAssetPath)
Crea un'istanza
FaceLandmarker da un percorso del pacchetto di asset modello e dal valore predefinito FaceLandmarker.FaceLandmarkerOptions . |
statico FaceLandmarker |
createFromFile(Contesto del contesto, File modelAssetFile)
Crea un'istanza
FaceLandmarker da un file di bundle di asset modello e il valore predefinito FaceLandmarker.FaceLandmarkerOptions . |
statico FaceLandmarker |
createFromOptions(Context context, FaceLandmarker.FaceLandmarkerOptions distintierOptions)
Crea un'istanza
FaceLandmarker da un FaceLandmarker.FaceLandmarkerOptions . |
FaceLandmarkerResult | |
FaceLandmarkerResult |
detect(MPImage immagine, ImageProcessingOptions imageElaborazioneOptions)
Esegue il rilevamento dei punti di riferimento 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 punti di riferimento del volto e i risultati saranno disponibili
tramite il
OutputHandler.ResultListener fornito in FaceLandmarker.FaceLandmarkerOptions . |
void |
detectAsync(immagine MPImage, timestamp lunghiM)
Invia i dati delle immagini in tempo reale per il rilevamento dei punti di riferimento del volto con opzioni di elaborazione delle immagini predefinite, ad esempio
|
FaceLandmarkerResult |
detectForVideo(MPImage immagine, ImageProcessingOptions imageElaborazioneOptions, timestamp lunghiMs)
Esegue il rilevamento dei punti di riferimento del volto sul fotogramma video fornito.
|
FaceLandmarkerResult |
detectForVideo(immagine MPImage, timestamp lunghiM)
Esegue il rilevamento dei punti di riferimento dei volti sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ad esempio
|
Metodi ereditati
Campi
Metodi pubblici
pubblico statico FaceLandmarker createFromBuffer (Context context, ByteBuffer modelAssetBuffer)
Crea un'istanza FaceLandmarker
da un buffer del bundle di asset modello e dal valore predefinito FaceLandmarker.FaceLandmarkerOptions
.
Parametri
context | un ERROR(/Context) Android. |
---|---|
modelAssetBuffer |
Lanci
in caso di errore durante la creazione di FaceLandmarker .
|
pubblico statico FaceLandmarker createFromFile (Context context, String modelAssetPath)
Crea un'istanza FaceLandmarker
da un percorso del pacchetto di asset modello e dal valore predefinito FaceLandmarker.FaceLandmarkerOptions
.
Parametri
context | un ERROR(/Context) Android. |
---|---|
modelAssetPath | percorso del modello dei punti di riferimento dei volti con metadati nelle risorse. |
Lanci
in caso di errore durante la creazione di FaceLandmarker .
|
pubblico statico FaceLandmarker createFromFile (Context context, File modelAssetFile)
Crea un'istanza FaceLandmarker
da un file di bundle di asset modello e il valore predefinito FaceLandmarker.FaceLandmarkerOptions
.
Parametri
context | un ERROR(/Context) Android. |
---|---|
modelAssetFile | l'istanza del modello File dei punti di riferimento dei volti. |
Lanci
IOException | se si verifica un errore I/O all'apertura del file del modello tflite. |
---|---|
in caso di errore durante la creazione di FaceLandmarker .
|
pubblico statico FaceLandmarker createFromOptions (Context context, FaceLandmarker.FaceLandmarkerOptions LandmarkerOptions)
Crea un'istanza FaceLandmarker
da un FaceLandmarker.FaceLandmarkerOptions
.
Parametri
context | un ERROR(/Context) Android. |
---|---|
landmarkerOptions | un'istanza FaceLandmarker.FaceLandmarkerOptions . |
Lanci
in caso di errore durante la creazione di FaceLandmarker .
|
pubblici FaceLandmarkerResult detect (MPImage immagine)
Esegue il rilevamento dei punti di riferimento dei volti sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. Utilizza questo metodo solo quando FaceLandmarker
viene creato con ERROR(/RunningMode.IMAGE)
. DA FARE aggiornare il documento Java
per il formato dell'immagine di input.
FaceLandmarker
supporta i seguenti tipi di spazi colore:
Parametri
immagine | un oggetto MPImage di MediaPipe per l'elaborazione. |
---|
Lanci
in caso di errore interno. |
pubblici FaceLandmarkerResult detect (MPImage immagine, ImageProcessingOptions imageElaborazioneOptions)
Esegue il rilevamento dei punti di riferimento dei volti sulla singola immagine fornita. Utilizza questo metodo solo quando
FaceLandmarker
viene creato con ERROR(/RunningMode.IMAGE)
. DA FARE aggiornare il documento Java per il formato dell'immagine di input.
FaceLandmarker
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 punti di riferimento del volto e i risultati saranno disponibili
tramite il OutputHandler.ResultListener
fornito in FaceLandmarker.FaceLandmarkerOptions
. Utilizza questo metodo solo quando FaceLandmarker
viene creato con ERROR(/RunningMode.LIVE_STREAM)
.
È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata all'elemento di riferimento dei volti. I timestamp di input devono essere crescenti in modo monotonico.
FaceLandmarker
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 punti di riferimento del volto con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione, e i risultati saranno disponibili tramite il OutputHandler.ResultListener
fornito in FaceLandmarker.FaceLandmarkerOptions
. Utilizza questo metodo solo quando
FaceLandmarker
viene creato con ERROR(/RunningMode.LIVE_STREAM)
.
È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata all'elemento di riferimento dei volti. I timestamp di input devono essere crescenti in modo monotonico.
FaceLandmarker
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 FaceLandmarkerResult detectForVideo (MPImage immagine, ImageProcessingOptions imageProcessOptions, timestamp lunghiMs)
Esegue il rilevamento dei punti di riferimento del volto sul fotogramma video fornito. Utilizza questo metodo solo quando
FaceLandmarker
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.
FaceLandmarker
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. |
pubblici FaceLandmarkerResult detectForVideo (immagine MPImage, timestamp lungoMs)
Esegue il rilevamento dei punti di riferimento dei volti sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. Utilizza questo metodo solo quando FaceLandmarker
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.
FaceLandmarker
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. |