Przedstawiamy Google AI Edge Portal: benchmark Edge AI na dużą skalę. Zarejestruj się, aby poprosić o dostęp podczas wersji prywatnej.

FaceLandmarker

publiczna klasa finałowa FaceLandmarker

Wykrywanie na zdjęciach punktów orientacyjnych twarzy.

Ten interfejs API wymaga wytrenowanego pakietu zasobów z modelem punktów orientacyjnych twarzy. Patrz sekcja .

Obraz wejściowy MPImage
- Obraz, na którym wykrywane są punkty orientacyjne.
Dane wyjściowe FaceLandmarkerResult
- Obiekt FaceLandmarkerResult zawierający punkty orientacyjne twarzy.

Zagnieżdżone klasy

klasa FaceLandmarker.FaceLandmarkerOptions Opcje konfigurowania: FaceLandmarker

Pola

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

Metody publiczne

statyczny FaceLandmarker	createFromBuffer(kontekst, zasób ByteBuffer) Tworzy instancję `FaceLandmarker` z bufora pakietu zasobów modelu i domyślnej wartości `FaceLandmarker.FaceLandmarkerOptions`.
statyczny FaceLandmarker	createFromFile(Kontekst; ciąg znaków modelAssetPath) Tworzy instancję `FaceLandmarker` na podstawie ścieżki pakietu zasobów modelu i domyślnej wartości `FaceLandmarker.FaceLandmarkerOptions`.
statyczny FaceLandmarker	createFromFile(Kontekst; Plik modelAssetFile) Tworzy instancję `FaceLandmarker` z pliku pakietu zasobów modelu i domyślnej wartości `FaceLandmarker.FaceLandmarkerOptions`.
statyczny FaceLandmarker	createFromOptions(Kontekst kontekst, FaceLandmarker.FaceLandmarkerOptions destinationerOptions) Tworzy instancję `FaceLandmarker` z `FaceLandmarker.FaceLandmarkerOptions`.
FaceLandmarkerResult	detect(obraz MPImage) Wykrywanie punktów orientacyjnych twarzy na pojedynczym zdjęciu przy użyciu domyślnych opcji przetwarzania obrazu, tj.
FaceLandmarkerResult	detect(obraz MPImage, ImageProcessingOptions imageProcessingOptions) Wykrywanie punktów orientacyjnych twarzy na pojedynczym zdjęciu.
void	detectAsync(obraz MPImage, ImageProcessingOptions imageProcessingOptions, long timestampMs) Wysyła aktualne dane zdjęcia w celu wykrywania punktów orientacyjnych twarzy, a wyniki będą dostępne za pomocą funkcji `OutputHandler.ResultListener` w interfejsie `FaceLandmarker.FaceLandmarkerOptions`.
void	detectAsync(obraz MPImage, długie sygnatury czasowe) Wysyła aktualne dane zdjęcia w celu wykrywania punktów orientacyjnych twarzy za pomocą domyślnych opcji przetwarzania obrazu, np.
FaceLandmarkerResult	detectForVideo(obraz MPImage, ImageProcessingOptions imageProcessingOptions, długi timestampMs) Wykrywanie punktów orientacyjnych twarzy w dostarczonej klatce wideo.
FaceLandmarkerResult	detectForVideo(obraz MPImage, długie sygnatury czasowe) Wykrywanie punktów orientacyjnych twarzy w dostarczonej klatce wideo z domyślnymi opcjami przetwarzania obrazu, tj.

Metody dziedziczone

Z klasy com.google.mediapipe.tasks.vision.core.BaseVisionTaskApi

void	close() Zamyka i czyści zadanie wizualne MediaPipe.
statyczny długi czas trwania	generateResultTimestampMs(RunningMode runningMode, pakiet SDK) Generuje sygnaturę czasową obiektu wyniku zadania wizyjnego z trybu działania zadania wizyjnego i pakietu wyjściowego.

Z klasy java.lang.Object

boolean	równa się(Object arg0)
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	czas()

Z interfejsu java.lang.AutoCloseable

abstrakcja void

close()

Pola

public static final Ustaw<Połączenie> FACE_LANDMARKS_CONNECTORS

public static final Ustaw<Połączenie> FACE_LANDMARKS_FACE_OVAL

public static final Ustaw<Połączenie> FACE_LANDMARKS_LEFT_EYE

public static final Ustaw<Połączenie> FACE_LANDMARKS_LEFT_EYE_BROW

public static final Ustaw<Połączenie> FACE_LANDMARKS_LEFT_IRIS

public static final Ustaw<Połączenie> FACE_LANDMARKS_LIPS

public static final Ustaw<Połączenie> FACE_LANDMARKS_RIGHT_EYE

public static final Ustaw<Połączenie> FACE_LANDMARKS_RIGHT_EYE_BROW

public static final Ustaw<Połączenie> FACE_LANDMARKS_RIGHT_IRIS

public static final Ustaw<Połączenie> FACE_LANDMARKS_TESSELATION

Metody publiczne

public static FaceLandmarker createFromBuffer (Kontekst kontekstu, ByteBuffer modelAssetBuffer)

Tworzy instancję FaceLandmarker z bufora pakietu zasobów modelu i domyślnej wartości FaceLandmarker.FaceLandmarkerOptions.

Parametry

sytuacja	`ERROR(/Context)` na Androidzie.
modelAssetBuffer

Rzuty

	jeśli podczas tworzenia zbioru danych `FaceLandmarker` wystąpi błąd.

public static FaceLandmarker createFromFile (Kontekst kontekstu, Ciąg modelAssetPath)

Tworzy instancję FaceLandmarker na podstawie ścieżki pakietu zasobów modelu i domyślnej wartości FaceLandmarker.FaceLandmarkerOptions.

Parametry

sytuacja	`ERROR(/Context)` na Androidzie.
modelAssetPath	ścieżki do modelu punktów orientacyjnych twarzy z metadanymi w zasobach.

Rzuty

	jeśli podczas tworzenia zbioru danych `FaceLandmarker` wystąpi błąd.

public static FaceLandmarker createFromFile (Kontekst kontekstu, Plik modelAssetFile)

Tworzy instancję FaceLandmarker z pliku pakietu zasobów modelu i domyślnej wartości FaceLandmarker.FaceLandmarkerOptions.

Parametry

sytuacja	`ERROR(/Context)` na Androidzie.
modelAssetFile	model `File` twarzy.

Rzuty

IOException	jeśli podczas otwierania pliku modelu tflite wystąpi błąd wejścia-wyjścia.
	jeśli podczas tworzenia zbioru danych `FaceLandmarker` wystąpi błąd.

public static FaceLandmarker createFromOptions (Kontekst kontekst, FaceLandmarker.FaceLandmarkerOptions pointerOptions)

Tworzy instancję FaceLandmarker z FaceLandmarker.FaceLandmarkerOptions.

Parametry

sytuacja	`ERROR(/Context)` na Androidzie.
landmarkerOptions	instancję `FaceLandmarker.FaceLandmarkerOptions`.

Rzuty

	jeśli podczas tworzenia zbioru danych `FaceLandmarker` wystąpi błąd.

public FaceLandmarkerResult detect (obraz MPImage)

Wykrywanie punktów orientacyjnych twarzy na pojedynczym zdjęciu przy użyciu domyślnych opcji przetwarzania obrazu, tj. bez zastosowania rotacji. Używaj tej metody tylko wtedy, gdy tworzony jest FaceLandmarker za pomocą ERROR(/RunningMode.IMAGE). TODO zaktualizuj dokument Java pod kątem formatu obrazu wejściowego.

FaceLandmarker obsługuje te typy przestrzeni kolorów:

ERROR(/Bitmap.Config.ARGB_8888)

Parametry

obraz	do przetwarzania obiektu MediaPipe `MPImage`.

Rzuty

	jeśli wystąpił błąd wewnętrzny.

public FaceLandmarkerResult detect (obraz MPImage, ImageProcessingOptions imageProcessingOptions)

Wykrywanie punktów orientacyjnych twarzy na pojedynczym zdjęciu. Używaj tej metody tylko wtedy, gdy obiekt FaceLandmarker został utworzony za pomocą ERROR(/RunningMode.IMAGE). TODO Zaktualizuj dokument Java pod kątem formatu obrazu wejściowego.

FaceLandmarker obsługuje te typy przestrzeni kolorów:

ERROR(/Bitmap.Config.ARGB_8888)

Parametry

obraz	do przetwarzania obiektu MediaPipe `MPImage`.
imageProcessingOptions	`ImageProcessingOptions` określający sposób przetwarzania obrazu wejściowego przed uruchomieniem wnioskowania. Zwróć uwagę, że to zadanie nie obsługuje regionu zainteresowań: określenie wartości `ImageProcessingOptions.regionOfInterest()` spowoduje, że ta metoda spowoduje zgłoszenie wyjątku IllegalArgumentException.

Rzuty

IllegalArgumentException	jeśli `ImageProcessingOptions` określa region zainteresowań.
	jeśli wystąpił błąd wewnętrzny.

public void detectAsync (obraz MPImage, ImageProcessingOptions imageProcessingOptions, długi timestampMs)

Wysyła aktualne dane zdjęcia w celu wykrywania punktów orientacyjnych twarzy, a wyniki będą dostępne za pomocą funkcji OutputHandler.ResultListener w interfejsie FaceLandmarker.FaceLandmarkerOptions. Używaj tej metody tylko wtedy, gdy FaceLandmarker zostaje utworzony za pomocą ERROR(/RunningMode.LIVE_STREAM).

Wymagane jest podanie sygnatury czasowej (w milisekundach), która wskazuje, kiedy obraz wejściowych ma zostać wysłany do elementu orientacyjnego z rozpoznawaniem twarzy. Podane sygnatury czasowe muszą rosnąć monotonicznie.

FaceLandmarker obsługuje te typy przestrzeni kolorów:

ERROR(/Bitmap.Config.ARGB_8888)

Parametry

obraz	do przetwarzania obiektu MediaPipe `MPImage`.
imageProcessingOptions	`ImageProcessingOptions` określający sposób przetwarzania obrazu wejściowego przed uruchomieniem wnioskowania. Zwróć uwagę, że to zadanie nie obsługuje regionu zainteresowań: określenie wartości `ImageProcessingOptions.regionOfInterest()` spowoduje, że ta metoda spowoduje zgłoszenie wyjątku IllegalArgumentException.
timestampMs	wejściową sygnaturę czasową (w milisekundach).

Rzuty

IllegalArgumentException	jeśli `ImageProcessingOptions` określa region zainteresowań.
	jeśli wystąpił błąd wewnętrzny.

public void detectAsync (obraz MPImage, długie sygnatura czasowa)

Wysyła bieżące dane zdjęcia, aby umożliwić wykrywanie punktów orientacyjnych twarzy przy użyciu domyślnych opcji przetwarzania obrazu, tj.bez zastosowania rotacji. Wyniki będą dostępne za pomocą funkcji OutputHandler.ResultListener podanej w FaceLandmarker.FaceLandmarkerOptions. Używaj tej metody tylko wtedy, gdy obiekt FaceLandmarker został utworzony za pomocą ERROR(/RunningMode.LIVE_STREAM).

FaceLandmarker obsługuje te typy przestrzeni kolorów:

ERROR(/Bitmap.Config.ARGB_8888)

Parametry

obraz	do przetwarzania obiektu MediaPipe `MPImage`.
timestampMs	wejściową sygnaturę czasową (w milisekundach).

Rzuty

	jeśli wystąpił błąd wewnętrzny.

public FaceLandmarkerResult detectForVideo (obraz MPImage, ImageProcessingOptions imageProcessingOptions, long timestampMs)

Wykrywanie punktów orientacyjnych twarzy w dostarczonej klatce wideo. Używaj tej metody tylko wtedy, gdy obiekt FaceLandmarker został utworzony za pomocą ERROR(/RunningMode.VIDEO).

Wymagane jest podanie sygnatury czasowej klatki wideo (w milisekundach). Wejściowe sygnatury czasowe muszą rosnąć monotonicznie.

FaceLandmarker obsługuje te typy przestrzeni kolorów:

ERROR(/Bitmap.Config.ARGB_8888)

Parametry

obraz	do przetwarzania obiektu MediaPipe `MPImage`.
imageProcessingOptions	`ImageProcessingOptions` określający sposób przetwarzania obrazu wejściowego przed uruchomieniem wnioskowania. Zwróć uwagę, że to zadanie nie obsługuje regionu zainteresowań: określenie wartości `ImageProcessingOptions.regionOfInterest()` spowoduje, że ta metoda spowoduje zgłoszenie wyjątku IllegalArgumentException.
timestampMs	wejściową sygnaturę czasową (w milisekundach).

Rzuty

IllegalArgumentException	jeśli `ImageProcessingOptions` określa region zainteresowań.
	jeśli wystąpił błąd wewnętrzny.

public FaceLandmarkerResult detectForVideo (obraz MPImage, długie sygnatury czasowe)

Wykrywanie punktów orientacyjnych twarzy w dostarczonej ramce wideo z domyślnymi opcjami przetwarzania obrazu, tj. bez zastosowania rotacji. Używaj tej metody tylko wtedy, gdy tworzony jest FaceLandmarker za pomocą ERROR(/RunningMode.VIDEO).

Wymagane jest podanie sygnatury czasowej klatki wideo (w milisekundach). Wejściowe sygnatury czasowe muszą rosnąć monotonicznie.

FaceLandmarker obsługuje te typy przestrzeni kolorów:

ERROR(/Bitmap.Config.ARGB_8888)

Parametry

obraz	do przetwarzania obiektu MediaPipe `MPImage`.
timestampMs	wejściową sygnaturę czasową (w milisekundach).

Rzuty

	jeśli wystąpił błąd wewnętrzny.