Google AI Edge Portal: Edge-KI im großen Maßstab benchmarken. Melden Sie sich an, um während der privaten Vorschau Zugriff anzufordern.

Diese Seite wurde von der Cloud Translation API übersetzt.

FaceDetector

public final class FaceDetector

Führt eine Gesichtserkennung auf Bildern durch.

Die API erwartet ein TFLite-Modell mit TFLite-Modellmetadaten.

Eingabebild MPImage
- Das Bild, auf dem die Gesichtserkennung ausgeführt wird.
FaceDetectorResult FaceDetectorResult-Ausgabe
- Ein FaceDetectorResult mit erkannten Gesichtern.

Verschachtelte Klassen

Klasse FaceDetector.FaceDetectorOptions Optionen zum Einrichten eines FaceDetector-Objekts.

Public Methods

Statischer FaceDetector	createFromBuffer(Kontextkontext, ByteBuffer modelBuffer) Erstellt eine `FaceDetector`-Instanz aus einem Modellpuffer und dem Standardwert `FaceDetector.FaceDetectorOptions`.
Statischer FaceDetector	createFromFile(Kontextkontext, String ModelPath) Erstellt eine `FaceDetector`-Instanz aus einer Modelldatei und der Standard-`FaceDetector.FaceDetectorOptions`.
Statischer FaceDetector	createFromFile(Kontextkontext, File-Modelldatei) Erstellt eine `FaceDetector`-Instanz aus einer Modelldatei und der Standard-`FaceDetector.FaceDetectorOptions`.
Statischer FaceDetector	createFromOptions(Kontextkontext, FaceDetector.FaceDetectorOptions-Detektoroptionen) Erstellt eine `FaceDetector`-Instanz aus einer `FaceDetector.FaceDetectorOptions`.
FaceDetectorResult	detect(MPImage-Bild) Führt eine Gesichtserkennung auf dem bereitgestellten Einzelbild mit Standardbildverarbeitungsoptionen durch, z.B.
FaceDetectorResult	detect(MPImage-Bild, ImageProcessingOptions imageProcessingOptions) Führt eine Gesichtserkennung für das bereitgestellte Einzelbild durch.
void	detectAsync(MPImage-Bild, ImageProcessingOptions imageProcessingOptions, longtimestampMs) Sendet Live-Bilddaten, um eine Gesichtserkennung durchzuführen. Die Ergebnisse werden über die `OutputHandler.ResultListener` in der `FaceDetector.FaceDetectorOptions` verfügbar gemacht.
void	detectAsync(MPImage-Image, langer ZeitstempelMs) Sendet Live-Bilddaten, um eine Gesichtserkennung mit Standard-Bildverarbeitungsoptionen wie
FaceDetectorResult	detectForVideo(MPImage-Bild, ImageProcessingOptions imageProcessingOptions, long timestampMs) Führt eine Gesichtserkennung auf dem bereitgestellten Videoframe durch.
FaceDetectorResult	detectForVideo(MPImage-Bild, langer ZeitstempelMs) Führt eine Gesichtserkennung auf dem bereitgestellten Videoframe mit Standardoptionen für die Bildverarbeitung durch, z.B.

Übernommene Methoden

Aus Klasse com.google.mediapipe.tasks.vision.core.BaseVisionTaskApi

void	close() Schließt und bereinigt die MediaPipe-Visionsaufgabe.
statisch lang	generateResultTimestampMs(RunningMode runningMode, Paketpaket) Generiert den Zeitstempel eines Ergebnisobjekts einer Vision-Aufgabe aus dem Ausführungsmodus der Vision-Aufgabe und dem Ausgabepaket.

Aus Klasse java.lang.Object

boolean	equals(Objekt arg0)
final Class<?>	getClass()
int	hashCode()
endgültig void	notify()
endgültig void	notifyAll()
String	toString()
endgültig void	wait(long arg0, int arg1)
endgültig void	wait(lange arg0)
endgültig void	wait()

Von Interface java.lang.AutoCloseable

Abstrakt void

close()

Public Methods

public static FaceDetector createFromBuffer (Kontextkontext, ByteBuffer modelBuffer)

Erstellt eine FaceDetector-Instanz aus einem Modellpuffer und dem Standardwert FaceDetector.FaceDetectorOptions.

Parameter

context	ein Android-`ERROR(/Context)`.
modelBuffer	ein direktes `ByteBuffer` oder ein `ERROR(/MappedByteBuffer)` des Erkennungsmodells.

Löst aus

	Wenn beim Erstellen von `FaceDetector` ein Fehler auftritt.

public static FaceDetector createFromFile (Kontextkontext, String modelPath)

Erstellt eine FaceDetector-Instanz aus einer Modelldatei und der Standard-FaceDetector.FaceDetectorOptions.

Parameter

context	ein Android-`ERROR(/Context)`.
modelPath	zum Erkennungsmodell mit Metadaten in den Assets.

Löst aus

	Wenn beim Erstellen von `FaceDetector` ein Fehler auftritt.

public static FaceDetector createFromFile (Kontextkontext, Datei Modelldatei)

Erstellt eine FaceDetector-Instanz aus einer Modelldatei und der Standard-FaceDetector.FaceDetectorOptions.

Parameter

context	ein Android-`ERROR(/Context)`.
modelFile	die `File`-Instanz des Erkennungsmodells.

Löst aus

IOException	Wenn beim Öffnen der TFlite-Modelldatei ein E/A-Fehler auftritt.
	Wenn beim Erstellen von `FaceDetector` ein Fehler auftritt.

public static FaceDetector createFromOptions (Kontextkontext, FaceDetector.FaceDetectorOptions-Detektoroptionen)

Erstellt eine FaceDetector-Instanz aus einer FaceDetector.FaceDetectorOptions.

Parameter

context	ein Android-`ERROR(/Context)`.
detectorOptions	Eine `FaceDetector.FaceDetectorOptions`-Instanz.

Löst aus

	Wenn beim Erstellen von `FaceDetector` ein Fehler auftritt.

public FaceDetectorResult detect (MPImage-Bild)

Führt eine Gesichtserkennung auf dem bereitgestellten Einzelbild mit Standardoptionen für die Bildverarbeitung durch, d.h. ohne Drehung. Verwenden Sie diese Methode nur, wenn das FaceDetector mit ERROR(/RunningMode.IMAGE) erstellt wird.

FaceDetector unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung

Löst aus

	wenn ein interner Fehler vorliegt.

public FaceDetectorResult detect (MPImage-Bild, ImageProcessingOptions imageProcessingOptions)

Führt eine Gesichtserkennung für das bereitgestellte Einzelbild durch. Verwenden Sie diese Methode nur, wenn das FaceDetector mit ERROR(/RunningMode.IMAGE) erstellt wird.

FaceDetector unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung
imageProcessingOptions	den `ImageProcessingOptions`, der angibt, wie das Eingabebild vor dem Ausführen der Inferenz verarbeitet wird. Beachten Sie, dass die Region von Interesse von dieser Aufgabe nicht unterstützt wird: Die Angabe von `ImageProcessingOptions.regionOfInterest()` führt dazu, dass diese Methode eine geschmeidige Ausnahme auslöst.

Löst aus

IllegalArgumentException	wenn `ImageProcessingOptions` eine relevante Region angibt.
	wenn ein interner Fehler vorliegt.

public void detectAsync (MPImage-Bild, ImageProcessingOptions imageProcessingOptions, long timestampMs)

Sendet Live-Bilddaten, um eine Gesichtserkennung durchzuführen. Die Ergebnisse werden über die OutputHandler.ResultListener in der FaceDetector.FaceDetectorOptions verfügbar gemacht. Verwenden Sie diese Methode nur, wenn das FaceDetector mit ERROR(/RunningMode.LIVE_STREAM) erstellt wird.

Die Angabe eines Zeitstempels (in Millisekunden) muss angegeben werden, um anzugeben, wann das Eingabebild an den Gesichtserkennung gesendet wird. Die Eingabezeitstempel müssen kontinuierlich ansteigen.

FaceDetector unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung
imageProcessingOptions	den `ImageProcessingOptions`, der angibt, wie das Eingabebild vor dem Ausführen der Inferenz verarbeitet wird. Beachten Sie, dass die Region von Interesse von dieser Aufgabe nicht unterstützt wird: Die Angabe von `ImageProcessingOptions.regionOfInterest()` führt dazu, dass diese Methode eine geschmeidige Ausnahme auslöst.
timestampMs	den Eingabezeitstempel (in Millisekunden).

Löst aus

IllegalArgumentException	wenn `ImageProcessingOptions` eine relevante Region angibt.
	wenn ein interner Fehler vorliegt.

public void detectAsync (MPImage-Image, long timestampMs)

Sendet Live-Bilddaten, um eine Gesichtserkennung mit standardmäßigen Bildverarbeitungsoptionen ohne Drehung durchzuführen. Die Ergebnisse sind über die OutputHandler.ResultListener in der FaceDetector.FaceDetectorOptions verfügbar. Verwenden Sie diese Methode nur, wenn das FaceDetector mit ERROR(/RunningMode.LIVE_STREAM) erstellt wird.

FaceDetector unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung
timestampMs	den Eingabezeitstempel (in Millisekunden).

Löst aus

	wenn ein interner Fehler vorliegt.

public FaceDetectorResult detectForVideo (MPImage-Bild, ImageProcessingOptions imageProcessingOptions, long timestampMs)

Führt eine Gesichtserkennung auf dem bereitgestellten Videoframe durch. Verwenden Sie diese Methode nur, wenn das FaceDetector mit ERROR(/RunningMode.VIDEO) erstellt wird.

Sie müssen den Zeitstempel des Videoframes (in Millisekunden) angeben. Die Eingabezeitstempel müssen kontinuierlich ansteigen.

FaceDetector unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung
imageProcessingOptions	den `ImageProcessingOptions`, der angibt, wie das Eingabebild vor dem Ausführen der Inferenz verarbeitet wird. Beachten Sie, dass die Region von Interesse von dieser Aufgabe nicht unterstützt wird: Die Angabe von `ImageProcessingOptions.regionOfInterest()` führt dazu, dass diese Methode eine geschmeidige Ausnahme auslöst.
timestampMs	den Eingabezeitstempel (in Millisekunden).

Löst aus

IllegalArgumentException	wenn `ImageProcessingOptions` eine relevante Region angibt.
	wenn ein interner Fehler vorliegt.

public FaceDetectorResult detectForVideo (MPImage-Bild, langer ZeitstempelMs)

Führt eine Gesichtserkennung auf dem bereitgestellten Videoframe mit Standardoptionen für die Bildverarbeitung aus, d.h. ohne Drehung. Verwenden Sie diese Methode nur, wenn das FaceDetector mit ERROR(/RunningMode.VIDEO) erstellt wird.

Sie müssen den Zeitstempel des Videoframes (in Millisekunden) angeben. Die Eingabezeitstempel müssen kontinuierlich ansteigen.

FaceDetector unterstützt die folgenden Farbraumtypen:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

Image	Ein MediaPipe-`MPImage`-Objekt zur Verarbeitung
timestampMs	den Eingabezeitstempel (in Millisekunden).

Löst aus

	wenn ein interner Fehler vorliegt.