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.

FaceDetector

classe finale publique FaceDetector

Effectue une détection des visages sur des images.

L'API attend un modèle TFLite avec des métadonnées de modèle TFLite.

Image d'entrée MPImage
- Image sur laquelle le détecteur de visages est exécuté.
Sortie FaceDetectorResult FaceDetectorResult
- FaceDetectorResult contenant les visages détectés.

Classes imbriquées

classe FaceDetector.FaceDetectorOptions Options de configuration d'un FaceDetector.

Méthodes publiques

FaceDetector	createFromBuffer(contexte de contexte, modelBuffer ByteBuffer) Crée une instance `FaceDetector` à partir d'un tampon de modèle et la valeur `FaceDetector.FaceDetectorOptions` par défaut.
FaceDetector	createFromFile(contexte de contexte, String modelPath) Crée une instance `FaceDetector` à partir d'un fichier de modèle et de la valeur `FaceDetector.FaceDetectorOptions` par défaut.
FaceDetector	createFromFile(contexte de contexte, File modelFile) Crée une instance `FaceDetector` à partir d'un fichier de modèle et de la valeur `FaceDetector.FaceDetectorOptions` par défaut.
FaceDetector	createFromOptions(contexte de contexte, FaceDetector.FaceDetectorOptions detectOptions) Crée une instance `FaceDetector` à partir d'un `FaceDetector.FaceDetectorOptions`.
FaceDetectorResult	detect(image MPImage) Effectue une détection des visages sur l'image unique fournie avec des options de traitement d'image par défaut (par exemple,
FaceDetectorResult	detect(image MPImage, ImageProcessingOptions imageProcessingOptions) Effectue une détection des visages sur l'image unique fournie.
void	detectAsync(image MPImage, ImageProcessingOptions imageProcessOptions, code temporel long) Envoie des données d'image en direct pour effectuer la détection des visages. Les résultats sont disponibles via le `OutputHandler.ResultListener` fourni dans le `FaceDetector.FaceDetectorOptions`.
void	detectAsync(image MPImage, code temporel long) Envoie des données d'images en direct pour effectuer la détection des visages à l'aide d'options de traitement d'image par défaut (par exemple,
FaceDetectorResult	detectForVideo(image MPImage, ImageProcessingOptions imageProcessingOptions, longtimestampMs) Effectue la détection des visages sur l'image vidéo fournie.
FaceDetectorResult	detectForVideo(image MPImage, code temporel long) Effectue la détection des visages sur l'image vidéo fournie avec les 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()

Méthodes publiques

public statique FaceDetector createFromBuffer (contexte de contexte, ByteBuffer modelBuffer)

Crée une instance FaceDetector à partir d'un tampon de modèle et la valeur FaceDetector.FaceDetectorOptions par défaut.

Paramètres

context	un `ERROR(/Context)` Android.
modelBuffer	un `ByteBuffer` ou un `ERROR(/MappedByteBuffer)` direct du modèle de détection.

Génère

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

public statique FaceDetector createFromFile (contexte de contexte, String modelPath)

Crée une instance FaceDetector à partir d'un fichier de modèle et de la valeur FaceDetector.FaceDetectorOptions par défaut.

Paramètres

context	un `ERROR(/Context)` Android.
modelPath	le chemin d'accès au modèle de détection avec les métadonnées dans les éléments.

Génère

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

public statique FaceDetector createFromFile (contexte de contexte, File modelFile)

Crée une instance FaceDetector à partir d'un fichier de modèle et de la valeur FaceDetector.FaceDetectorOptions par défaut.

Paramètres

context	un `ERROR(/Context)` Android.
modelFile	l'instance du modèle de détection `File`.

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 `FaceDetector`.

public statique FaceDetector createFromOptions (contexte de contexte, FaceDetector.FaceDetectorOptions detectOptions)

Crée une instance FaceDetector à partir d'un FaceDetector.FaceDetectorOptions.

Paramètres

context	un `ERROR(/Context)` Android.
detectorOptions	une instance `FaceDetector.FaceDetectorOptions`.

Génère

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

public FaceDetectorResult detect (image MPImage)

Effectue une détection des visages sur l'image unique 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 FaceDetector est créé avec ERROR(/RunningMode.IMAGE).

FaceDetector 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 FaceDetectorResult detect (image MPImage, ImageProcessingOptions imageProcessingOptions)

Effectue une détection des visages sur l'image unique fournie. N'utilisez cette méthode que lorsque le FaceDetector est créé avec ERROR(/RunningMode.IMAGE).

FaceDetector 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 effectuer la détection des visages. Les résultats sont disponibles via le OutputHandler.ResultListener fourni dans le FaceDetector.FaceDetectorOptions. N'utilisez cette méthode que lorsque le FaceDetector 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 au détecteur de visages. Les horodatages d'entrée doivent être croissants de manière monotone.

FaceDetector 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 effectuer la détection des visages avec les options de traitement d'image par défaut, c'est-à-dire sans rotation appliquée. Les résultats sont disponibles via le OutputHandler.ResultListener fourni dans le FaceDetector.FaceDetectorOptions. N'utilisez cette méthode que lorsque le FaceDetector est créé avec ERROR(/RunningMode.LIVE_STREAM).

FaceDetector 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 FaceDetectorResult detectForVideo (MPImage image, ImageProcessingOptions imageProcessingOptions, longTimestampMs)

Effectue la détection des visages sur l'image vidéo fournie. N'utilisez cette méthode que lorsque le FaceDetector 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.

FaceDetector 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 FaceDetectorResult detectForVideo (image MPImage, code temporel long)

Effectue la détection des visages sur l'image vidéo fournie avec les options de traitement d'image par défaut, c'est-à-dire sans rotation appliquée. N'utilisez cette méthode que lorsque le FaceDetector 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.

FaceDetector 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.