FaceLandmarker

public final class FaceLandmarker

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
detect(MPImage-Bild)
Führt die Erkennung von Gesichtsmerkmalen auf dem bereitgestellten Einzelbild mit Standard-Bildverarbeitungsoptionen durch, z.B.
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 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

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.