Führt die Erkennung von Gesichtsmerkmalen auf Bildern durch.
Diese API erwartet ein vortrainiertes Asset-Bundle für das Modell für Gesichtsmerkmale. Weitere Informationen finden Sie unter
- Eingabebild
MPImage
- Das Bild, auf dem die Erkennung von Gesichtsmerkmalen ausgeführt wird.
- Ausgabe
FaceLandmarkerResult
- FaceLandmarkerResult mit Gesichtsmarkierungen.
Verschachtelte Klassen
Klasse | FaceLandmarker.FaceLandmarkerOptions | Optionen zum Einrichten eines FaceLandmarker -Objekts. |
Felder
public static final Set<Connection> | FACE_LANDMARKS_CONNECTORS | |
public static final Set<Connection> | FACE_LANDMARKS_FACE_OVAL | |
public static final Set<Connection> | FACE_LANDMARKS_LEFT_EYE | |
public static final Set<Connection> | FACE_LANDMARKS_LEFT_EYE_BROW | |
public static final Set<Connection> | FACE_LANDMARKS_LEFT_IRIS | |
public static final Set<Connection> | FACE_LANDMARKS_LIPS | |
public static final Set<Connection> | FACE_LANDMARKS_RIGHT_EYE | |
public static final Set<Connection> | FACE_LANDMARKS_RIGHT_EYE_BROW | |
public static final Set<Connection> | FACE_LANDMARKS_RIGHT_IRIS | |
public static final Set<Connection> | FACE_LANDMARKS_TESSELATION |
Public Methods
static FaceLandmarker |
createFromBuffer(Kontextkontext, ByteBuffer modelAssetBuffer)
Erstellt eine
FaceLandmarker -Instanz aus einem Zwischenspeicher des Modell-Asset-Bundles und dem standardmäßigen FaceLandmarker.FaceLandmarkerOptions . |
static FaceLandmarker |
createFromFile(Kontextkontext, String-Modell-Asset-Pfad)
Erstellt eine
FaceLandmarker -Instanz aus einem Modell-Asset-Bundle-Pfad und dem Standard-FaceLandmarker.FaceLandmarkerOptions . |
static FaceLandmarker |
createFromFile(Kontextkontext, Datei-Modell-Asset-Datei)
Erstellt eine
FaceLandmarker -Instanz aus einer Modell-Asset-Bundle-Datei und der Standard-FaceLandmarker.FaceLandmarkerOptions . |
static FaceLandmarker |
createFromOptions(Context context, FaceLandmarker.FaceLandmarkerOptions LandmarkerOptions)
Erstellt eine
FaceLandmarker -Instanz aus einer FaceLandmarker.FaceLandmarkerOptions . |
FaceLandmarkerResult | |
FaceLandmarkerResult |
detect(MPImage-Bild, ImageProcessingOptions imageProcessingOptions)
Führt die Erkennung von Gesichtsmerkmalen auf dem bereitgestellten Einzelbild durch.
|
void |
detectAsync(MPImage-Bild, ImageProcessingOptions imageProcessingOptions, longtimestampMs)
Sendet Live-Bilddaten, um Gesichtsmerkmale zu erkennen. Die Ergebnisse werden über die in
FaceLandmarker.FaceLandmarkerOptions angegebene OutputHandler.ResultListener zur Verfügung gestellt. |
void |
detectAsync(MPImage-Image, langer ZeitstempelMs)
Sendet Live-Bilddaten, um die Erkennung von Gesichtsmerkmalen mit Standard-Bildverarbeitungsoptionen durchzuführen, z.B.
|
FaceLandmarkerResult |
detectForVideo(MPImage-Bild, ImageProcessingOptions imageProcessingOptions, long timestampMs)
Führt die Erkennung von Gesichtsmerkmalen im bereitgestellten Videoframe durch.
|
FaceLandmarkerResult |
detectForVideo(MPImage-Bild, langer ZeitstempelMs)
Führt die Erkennung von Gesichtsmerkmalen im bereitgestellten Videoframe mit Standard-Bildverarbeitungsoptionen durch, z.B.
|
Übernommene Methoden
Felder
Public Methods
public static FaceLandmarker createFromBuffer (Context context, ByteBuffer modelAssetBuffer)
Erstellt eine FaceLandmarker
-Instanz aus einem Zwischenspeicher des Modell-Asset-Bundles und dem standardmäßigen FaceLandmarker.FaceLandmarkerOptions
.
Parameter
context | ein Android-ERROR(/Context) . |
---|---|
modelAssetBuffer |
Löst aus
Wenn beim Erstellen von FaceLandmarker ein Fehler auftritt.
|
public static FaceLandmarker createFromFile (Context context, String modelAssetPath)
Erstellt eine FaceLandmarker
-Instanz aus einem Modell-Asset-Bundle-Pfad und dem Standard-FaceLandmarker.FaceLandmarkerOptions
.
Parameter
context | ein Android-ERROR(/Context) . |
---|---|
modelAssetPath | Pfad zum Modell der Gesichtsmerkmale mit Metadaten in den Assets. |
Löst aus
Wenn beim Erstellen von FaceLandmarker ein Fehler auftritt.
|
public static FaceLandmarker createFromFile (Kontextkontext, Datei ModellAssetFile)
Erstellt eine FaceLandmarker
-Instanz aus einer Modell-Asset-Bundle-Datei und der Standard-FaceLandmarker.FaceLandmarkerOptions
.
Parameter
context | ein Android-ERROR(/Context) . |
---|---|
modelAssetFile | File -Instanz des Modells für Gesichtsmarkierungen. |
Löst aus
IOException | Wenn beim Öffnen der TFlite-Modelldatei ein E/A-Fehler auftritt. |
---|---|
Wenn beim Erstellen von FaceLandmarker ein Fehler auftritt.
|
public static FaceLandmarker createFromOptions (Context context, FaceLandmarker.FaceLandmarkerOptions LandmarkerOptions)
Erstellt eine FaceLandmarker
-Instanz aus einer FaceLandmarker.FaceLandmarkerOptions
.
Parameter
context | ein Android-ERROR(/Context) . |
---|---|
landmarkerOptions | Eine FaceLandmarker.FaceLandmarkerOptions -Instanz. |
Löst aus
Wenn beim Erstellen von FaceLandmarker ein Fehler auftritt.
|
public FaceLandmarkerResult detect (MPImage-Bild)
Führt eine Erkennung von Gesichtsmerkmalen auf dem bereitgestellten Einzelbild mit Standard-Bildverarbeitungsoptionen durch, d.h. ohne Drehung. Verwenden Sie diese Methode nur, wenn das FaceLandmarker
mit ERROR(/RunningMode.IMAGE)
erstellt wird. TODO-Update der Java-Dokumentation für das Eingabebildformat.
FaceLandmarker
unterstützt die folgenden Farbraumtypen:
Parameter
Image | Ein MediaPipe-MPImage -Objekt zur Verarbeitung |
---|
Löst aus
wenn ein interner Fehler vorliegt. |
public FaceLandmarkerResult detect (MPImage-Bild, ImageProcessingOptions imageProcessingOptions)
Führt die Erkennung von Gesichtsmerkmalen auf dem bereitgestellten Einzelbild durch. Verwenden Sie diese Methode nur, wenn das FaceLandmarker
mit ERROR(/RunningMode.IMAGE)
erstellt wird. TODO-Aktualisierung der Java-Dokumentation für das Eingabebildformat.
FaceLandmarker
unterstützt die folgenden Farbraumtypen:
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 Gesichtsmerkmale zu erkennen. Die Ergebnisse werden über die in FaceLandmarker.FaceLandmarkerOptions
angegebene OutputHandler.ResultListener
zur Verfügung gestellt. Verwenden Sie diese Methode nur, wenn das FaceLandmarker
mit ERROR(/RunningMode.LIVE_STREAM)
erstellt wird.
Dabei muss ein Zeitstempel (in Millisekunden) angegeben werden, um anzugeben, wann das Eingabebild an die Gesichtsmarkierung gesendet wird. Die Eingabezeitstempel müssen kontinuierlich ansteigen.
FaceLandmarker
unterstützt die folgenden Farbraumtypen:
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 Gesichtsmerkmale mit standardmäßigen Bildverarbeitungsoptionen ohne Drehung zu erkennen. Die Ergebnisse sind über die in FaceLandmarker.FaceLandmarkerOptions
enthaltene OutputHandler.ResultListener
verfügbar. Verwenden Sie diese Methode nur, wenn das FaceLandmarker
mit ERROR(/RunningMode.LIVE_STREAM)
erstellt wird.
Dabei muss ein Zeitstempel (in Millisekunden) angegeben werden, um anzugeben, wann das Eingabebild an die Gesichtsmarkierung gesendet wird. Die Eingabezeitstempel müssen kontinuierlich ansteigen.
FaceLandmarker
unterstützt die folgenden Farbraumtypen:
Parameter
Image | Ein MediaPipe-MPImage -Objekt zur Verarbeitung |
---|---|
timestampMs | den Eingabezeitstempel (in Millisekunden). |
Löst aus
wenn ein interner Fehler vorliegt. |
public FaceLandmarkerResult detectForVideo (MPImage-Bild, ImageProcessingOptions imageProcessingOptions, long timestampMs)
Führt die Erkennung von Gesichtsmerkmalen im bereitgestellten Videoframe durch. Verwenden Sie diese Methode nur, wenn das FaceLandmarker
mit ERROR(/RunningMode.VIDEO)
erstellt wird.
Sie müssen den Zeitstempel des Videoframes (in Millisekunden) angeben. Die Eingabezeitstempel müssen kontinuierlich ansteigen.
FaceLandmarker
unterstützt die folgenden Farbraumtypen:
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 FaceLandmarkerResult detectForVideo (MPImage-Bild, langer ZeitstempelMs)
Führt die Erkennung von Gesichtsmerkmalen auf dem bereitgestellten Videoframe mit Standard-Bildverarbeitungsoptionen durch, d.h. ohne Drehung. Verwenden Sie diese Methode nur, wenn das FaceLandmarker
mit ERROR(/RunningMode.VIDEO)
erstellt wird.
Sie müssen den Zeitstempel des Videoframes (in Millisekunden) angeben. Die Eingabezeitstempel müssen kontinuierlich ansteigen.
FaceLandmarker
unterstützt die folgenden Farbraumtypen:
Parameter
Image | Ein MediaPipe-MPImage -Objekt zur Verarbeitung |
---|---|
timestampMs | den Eingabezeitstempel (in Millisekunden). |
Löst aus
wenn ein interner Fehler vorliegt. |