En savoir plus sur les annonces de Google AI Edge lors de la conférence I/O

Cette page a été traduite par l'API Cloud Translation.

FaceLandmarker

classe finale publique FaceLandmarker

Effectue la détection des points de repère de visage sur des images.

Cette API attend un lot d'assets de modèle de points de repère de visage pré-entraînés. Voir la section .

Image d'entrée MPImage
- Image sur laquelle s'exécute la détection des points de repère de visage.
Sortie FaceLandmarkerResult
- FaceLandMarkerResult contenant des points de repère de visage.

Classes imbriquées

classe FaceLandmarker.FaceLandmarkerOptions Options de configuration d'un FaceLandmarker.

Champs

public statique final Set<Connection>	FACE_LANDMARKS_CONNECTORS
public statique final Set<Connection>	FACE_LANDMARKS_FACE_OVAL
public statique final Set<Connection>	FACE_LANDMARKS_LEFT_EYE
public statique final Set<Connection>	FACE_LANDMARKS_LEFT_EYE_BROW
public statique final Set<Connection>	FACE_LANDMARKS_LEFT_IRIS
public statique final Set<Connection>	FACE_LANDMARKS_LIPS
public statique final Set<Connection>	FACE_LANDMARKS_RIGHT_EYE
public statique final Set<Connection>	FACE_LANDMARKS_RIGHT_EYE_BROW
public statique final Set<Connection>	FACE_LANDMARKS_RIGHT_IRIS
public statique final Set<Connection>	FACE_LANDMARKS_TESSELATION

Méthodes publiques

FaceLandmarker	createFromBuffer(contexte de contexte, ByteBuffer modelAssetBuffer) Crée une instance `FaceLandmarker` à partir d'un tampon de groupe d'éléments de modèle et de la valeur `FaceLandmarker.FaceLandmarkerOptions` par défaut.
FaceLandmarker	createFromFile(contexte de contexte, String modelAssetPath) Crée une instance `FaceLandmarker` à partir d'un chemin d'accès au bundle d'éléments du modèle et du `FaceLandmarker.FaceLandmarkerOptions` par défaut.
FaceLandmarker	createFromFile(contexte de contexte, File modelAssetFile) Crée une instance `FaceLandmarker` à partir d'un fichier de bundle d'éléments de modèle et de la valeur `FaceLandmarker.FaceLandmarkerOptions` par défaut.
FaceLandmarker	createFromOptions(contexte, FaceLandmarker.FaceLandmarkerOptions markerOptions) Crée une instance `FaceLandmarker` à partir d'un `FaceLandmarker.FaceLandmarkerOptions`.
FaceLandmarkerResult	detect(image MPImage) Effectue une détection des points de repère de visage sur l'image unique fournie avec des options de traitement d'image par défaut, telles que
FaceLandmarkerResult	detect(image MPImage, ImageProcessingOptions imageProcessingOptions) Effectue la détection des points de repère de visage sur l'image unique fournie.
void	detectAsync(image MPImage, ImageProcessingOptions imageProcessOptions, code temporel long) Envoie des données d'image en direct pour détecter les points de repère des visages. Les résultats sont disponibles via le `OutputHandler.ResultListener` fourni dans le `FaceLandmarker.FaceLandmarkerOptions`.
void	detectAsync(image MPImage, code temporel long) Envoie des données d'image en direct pour détecter les points de repère des visages avec des options de traitement d'image par défaut (ex. :
FaceLandmarkerResult	detectForVideo(image MPImage, ImageProcessingOptions imageProcessingOptions, longtimestampMs) Effectue la détection des points de repère des visages sur l'image vidéo fournie.
FaceLandmarkerResult	detectForVideo(image MPImage, code temporel long) Effectue la détection des points de repère de visages sur l'image vidéo fournie avec des options de traitement d'image par défaut (par exemple,

Méthodes héritées

De la classe com.google.mediapipe.tasks.vision.core.BaseVisionTaskApi

void	close() Ferme et nettoie la tâche de vision de MediaPipe.
statique long	generateResultTimestampMs(RunningMode runningMode, paquet de paquet) Génère l'horodatage d'un objet de résultat de tâche Vision à partir du mode d'exécution de la tâche Vision et du paquet de sortie.

Classe From java.lang.Object

boolean	equals(Object arg0)
finale Classe<?>	getClass()
int	hashCode()
final vide	notify()
final vide	notifyAll()
String	toString()
final vide	wait(long arg0, int arg1)
final vide	wait(long arg0)
final vide	wait()

Depuis l'interface java.lang.AutoCloseable

abstrait vide

fermer()

Champs

public statique final Définir<la connexion> FACE_LANDMARKS_CONNECTORS

public statique final Définir<la connexion> FACE_LANDMARKS_FACE_OVAL

public statique final Set<Connection> FACE_LANDMARKS_LEFT_EYE

public statique final Set<Connection> FACE_LANDMARKS_LEFT_EYE_BROW

public statique final Set<Connection> FACE_LANDMARKS_LEFT_IRIS

public statique final Set<Connection> FACE_LANDMARKS_LIPS

public statique final Définir<la connexion> FACE_LANDMARKS_RIGHT_EYE

public statique final Set<Connection> FACE_LANDMARKS_RIGHT_EYE_BROW

public statique final Set<Connection> FACE_LANDMARKS_RIGHT_IRIS

public statique final Set<Connection> FACE_LANDMARKS_TESSELATION

Méthodes publiques

public statique FaceLandmarker createFromBuffer (contexte contextuel, ByteBuffer modelAssetBuffer)

Crée une instance FaceLandmarker à partir d'un tampon de groupe d'éléments de modèle et de la valeur FaceLandmarker.FaceLandmarkerOptions par défaut.

Paramètres

context	un `ERROR(/Context)` Android.
modelAssetBuffer

Génère

	si une erreur se produit lors de la création de `FaceLandmarker`.

public statique FaceLandmarker createFromFile (contexte de contexte, String modelAssetPath)

Crée une instance FaceLandmarker à partir d'un chemin d'accès au bundle d'éléments du modèle et du FaceLandmarker.FaceLandmarkerOptions par défaut.

Paramètres

context	un `ERROR(/Context)` Android.
modelAssetPath	chemin d'accès au modèle des points de repère de visage avec les métadonnées dans les éléments.

Génère

	si une erreur se produit lors de la création de `FaceLandmarker`.

public statique FaceLandmarker createFromFile (contexte de contexte, File modelAssetFile)

Crée une instance FaceLandmarker à partir d'un fichier de bundle d'éléments de modèle et de la valeur FaceLandmarker.FaceLandmarkerOptions par défaut.

Paramètres

context	un `ERROR(/Context)` Android.
modelAssetFile	l'instance `File` du modèle de points de repère de visage.

Génère

IOException	si une erreur d'E/S se produit lors de l'ouverture du fichier de modèle tflite.
	si une erreur se produit lors de la création de `FaceLandmarker`.

public statique FaceLandmarker createFromOptions (contexte contextuel, FaceLandmarker.FaceLandmarkerOptions markerOptions)

Crée une instance FaceLandmarker à partir d'un FaceLandmarker.FaceLandmarkerOptions.

Paramètres

context	un `ERROR(/Context)` Android.
landmarkerOptions	une instance `FaceLandmarker.FaceLandmarkerOptions`.

Génère

	si une erreur se produit lors de la création de `FaceLandmarker`.

public FaceLandmarkerResult detect (MPImage image)

Effectue la détection des points de repère de visage sur l'image unique fournie avec des options de traitement d'image par défaut, c'est-à-dire sans appliquer de rotation. N'utilisez cette méthode que lorsque le FaceLandmarker est créé avec ERROR(/RunningMode.IMAGE). TODO pour mettre à jour le document Java pour le format d'image d'entrée.

FaceLandmarker accepte les types d'espaces colorimétriques suivants:

ERROR(/Bitmap.Config.ARGB_8888)

Paramètres

Image	un objet `MPImage` MediaPipe à traiter.

Génère

	en cas d'erreur interne.

public FaceLandmarkerResult detect (MPImage image, ImageProcessingOptions imageProcessingOptions)

Effectue la détection des points de repère de visage sur l'image unique fournie. N'utilisez cette méthode que lorsque l'élément FaceLandmarker est créé avec ERROR(/RunningMode.IMAGE). À FAIRE mettre à jour le document Java pour le format d'image d'entrée.

FaceLandmarker accepte les types d'espaces colorimétriques suivants:

ERROR(/Bitmap.Config.ARGB_8888)

Paramètres

Image	un objet `MPImage` MediaPipe à traiter.
imageProcessingOptions	Le `ImageProcessingOptions`, qui indique comment traiter l'image d'entrée avant d'exécuter l'inférence. Notez que la valeur de la région d'intérêt n'est pas prise en charge par cette tâche. Si vous spécifiez `ImageProcessingOptions.regionOfInterest()`, cette méthode générera une exception IllegalArgumentException.

Génère

IllegalArgumentException	si `ImageProcessingOptions` spécifie une région d'intérêt.
	en cas d'erreur interne.

public void detectAsync (MPImage image, ImageProcessingOptions imageProcessingOptions, longTimestampMs)

Envoie des données d'image en direct pour détecter les points de repère des visages. Les résultats sont disponibles via le OutputHandler.ResultListener fourni dans le FaceLandmarker.FaceLandmarkerOptions. N'utilisez cette méthode que lorsque l'élément FaceLandmarker est créé avec ERROR(/RunningMode.LIVE_STREAM).

Il est nécessaire de fournir un horodatage (en millisecondes) pour indiquer le moment où l'image d'entrée est envoyée à l'outil de repère de visage. Les horodatages d'entrée doivent être croissants de manière monotone.

FaceLandmarker accepte les types d'espaces colorimétriques suivants:

ERROR(/Bitmap.Config.ARGB_8888)

Paramètres

Image	un objet `MPImage` MediaPipe à traiter.
imageProcessingOptions	Le `ImageProcessingOptions`, qui indique comment traiter l'image d'entrée avant d'exécuter l'inférence. Notez que la valeur de la région d'intérêt n'est pas prise en charge par cette tâche. Si vous spécifiez `ImageProcessingOptions.regionOfInterest()`, cette méthode générera une exception IllegalArgumentException.
timestampMs	l'horodatage d'entrée (en millisecondes) ;

Génère

IllegalArgumentException	si `ImageProcessingOptions` spécifie une région d'intérêt.
	en cas d'erreur interne.

public void detectAsync (image MPImage, code temporel long)

Envoie des données d'image en direct pour détecter les points de repère de visages avec des options de traitement d'image par défaut (sans rotation appliquée) et les résultats sont disponibles via le OutputHandler.ResultListener fourni dans le FaceLandmarker.FaceLandmarkerOptions. N'utilisez cette méthode que lorsque l'élément FaceLandmarker est créé avec ERROR(/RunningMode.LIVE_STREAM).

FaceLandmarker accepte les types d'espaces colorimétriques suivants:

ERROR(/Bitmap.Config.ARGB_8888)

Paramètres

Image	un objet `MPImage` MediaPipe à traiter.
timestampMs	l'horodatage d'entrée (en millisecondes) ;

Génère

	en cas d'erreur interne.

public FaceLandmarkerResult detectForVideo (MPImage image, ImageProcessingOptions imageProcessingOptions, longTimestampMs)

Effectue la détection des points de repère des visages sur l'image vidéo fournie. N'utilisez cette méthode que lorsque l'élément FaceLandmarker est créé avec ERROR(/RunningMode.VIDEO).

Il est obligatoire de fournir le code temporel de l'image vidéo (en millisecondes). Les horodatages d'entrée doivent être croissants de manière monotone.

FaceLandmarker accepte les types d'espaces colorimétriques suivants:

ERROR(/Bitmap.Config.ARGB_8888)

Paramètres

Image	un objet `MPImage` MediaPipe à traiter.
imageProcessingOptions	Le `ImageProcessingOptions`, qui indique comment traiter l'image d'entrée avant d'exécuter l'inférence. Notez que la valeur de la région d'intérêt n'est pas prise en charge par cette tâche. Si vous spécifiez `ImageProcessingOptions.regionOfInterest()`, cette méthode générera une exception IllegalArgumentException.
timestampMs	l'horodatage d'entrée (en millisecondes) ;

Génère

IllegalArgumentException	si `ImageProcessingOptions` spécifie une région d'intérêt.
	en cas d'erreur interne.

public FaceLandmarkerResult detectForVideo (image MPImage, code temporel long)

Effectue la détection des points de repère de visages sur l'image vidéo fournie avec des options de traitement d'image par défaut, c'est-à-dire sans rotation appliquée. N'utilisez cette méthode que lorsque le FaceLandmarker est créé avec ERROR(/RunningMode.VIDEO).

Il est obligatoire de fournir le code temporel de l'image vidéo (en millisecondes). Les horodatages d'entrée doivent être croissants de manière monotone.

FaceLandmarker accepte les types d'espaces colorimétriques suivants:

ERROR(/Bitmap.Config.ARGB_8888)

Paramètres

Image	un objet `MPImage` MediaPipe à traiter.
timestampMs	l'horodatage d'entrée (en millisecondes) ;

Génère

	en cas d'erreur interne.