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

Ta strona została przetłumaczona przez Cloud Translation API.

FaceDetector

publiczna klasa finałowa FaceDetector

Wykrywanie twarzy na zdjęciach.

Interfejs API oczekuje modelu TFLite z metadanymi modelu TFLite.

Obraz wejściowy MPImage
- Obraz, na którym działa wykrywacz twarzy.
Wyjściowy wynik wykrywania twarzy: FaceDetectorResult
- Wynik wykrywania twarzy zawierający wykryte twarze.

Zagnieżdżone klasy

klasa FaceDetector.FaceDetectorOptions Opcje konfigurowania: FaceDetector

Metody publiczne

statyczny FaceDetector	createFromBuffer(kontekst kontekst, ByteBuffer modelBuffer) Tworzy instancję `FaceDetector` z bufora modelu i domyślnej wartości `FaceDetector.FaceDetectorOptions`.
statyczny FaceDetector	createFromFile(Kontekst; ciąg znaków modelPath) Tworzy instancję `FaceDetector` z pliku modelu i domyślne `FaceDetector.FaceDetectorOptions`.
statyczny FaceDetector	createFromFile(kontekst; plik modelFile) Tworzy instancję `FaceDetector` z pliku modelu i domyślne `FaceDetector.FaceDetectorOptions`.
statyczny FaceDetector	createFromOptions(Kontekst; FaceDetector.FaceDetectorOptions) Tworzy instancję `FaceDetector` z `FaceDetector.FaceDetectorOptions`.
FaceDetectorResult	detect(obraz MPImage) Wykrywanie twarzy na pojedynczym zdjęciu przy użyciu domyślnych opcji przetwarzania obrazu, np.
FaceDetectorResult	detect(obraz MPImage, ImageProcessingOptions imageProcessingOptions) Wykrywanie twarzy na pojedynczym zdjęciu.
void	detectAsync(obraz MPImage, ImageProcessingOptions imageProcessingOptions, long timestampMs) Wysyła aktualne dane zdjęcia w celu wykrywania twarzy, a wyniki będą dostępne przez `OutputHandler.ResultListener` w `FaceDetector.FaceDetectorOptions`.
void	detectAsync(obraz MPImage, długie sygnatury czasowe) Wysyła aktualne dane zdjęcia w celu wykrywania twarzy za pomocą domyślnych opcji przetwarzania obrazu, np.
FaceDetectorResult	detectForVideo(obraz MPImage, ImageProcessingOptions imageProcessingOptions, długi timestampMs) Wykrywanie twarzy w podanej klatce wideo.
FaceDetectorResult	detectForVideo(obraz MPImage, długie sygnatury czasowe) Wykrywanie twarzy w dostarczonej ramce 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()

Metody publiczne

public static FaceDetector createFromBuffer (Kontekst kontekstu, ByteBuffer modelBuffer)

Tworzy instancję FaceDetector z bufora modelu i domyślnej wartości FaceDetector.FaceDetectorOptions.

Parametry

sytuacja	`ERROR(/Context)` na Androidzie.
modelBuffer	bezpośrednie `ByteBuffer` lub `ERROR(/MappedByteBuffer)` modelu wykrywania.

Rzuty

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

public static FaceDetector createFromFile (Kontekst kontekstu, String modelPath)

Tworzy instancję FaceDetector z pliku modelu i domyślne FaceDetector.FaceDetectorOptions.

Parametry

sytuacja	`ERROR(/Context)` na Androidzie.
modelPath	do modelu wykrywania z metadanymi w zasobach.

Rzuty

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

public static FaceDetector createFromFile (Kontekst kontekst, Plik modelFile)

Tworzy instancję FaceDetector z pliku modelu i domyślne FaceDetector.FaceDetectorOptions.

Parametry

sytuacja	`ERROR(/Context)` na Androidzie.
modelFile	instancję modelu wykrywania `File`.

Rzuty

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

public static FaceDetector createFromOptions (Kontekst kontekst, FaceDetector.FaceDetectorOptionsdetectorOptions)

Tworzy instancję FaceDetector z FaceDetector.FaceDetectorOptions.

Parametry

sytuacja	`ERROR(/Context)` na Androidzie.
detectorOptions	instancję `FaceDetector.FaceDetectorOptions`.

Rzuty

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

public FaceDetectorResult detect (obraz MPImage)

Wykrywanie twarzy na pojedynczym zdjęciu przy użyciu domyślnych opcji przetwarzania obrazu, tj. bez zastosowania rotacji. Używaj tej metody tylko wtedy, gdy FaceDetector zostaje utworzony za pomocą ERROR(/RunningMode.IMAGE).

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

Wykrywanie twarzy na pojedynczym zdjęciu. Używaj tej metody tylko wtedy, gdy tworzony jest FaceDetector za pomocą ERROR(/RunningMode.IMAGE).

FaceDetector 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 twarzy, a wyniki będą dostępne przez OutputHandler.ResultListener w FaceDetector.FaceDetectorOptions. Używaj tej metody tylko wtedy, gdy FaceDetector 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 wykrywania twarzy. Podane sygnatury czasowe muszą rosnąć monotonicznie.

FaceDetector 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 aktualne dane zdjęcia w celu przeprowadzenia wykrywania twarzy przy użyciu domyślnych opcji przetwarzania obrazu, tj. bez zastosowania rotacji, a wyniki będą dostępne za pomocą interfejsu OutputHandler.ResultListener podanego w FaceDetector.FaceDetectorOptions. Używaj tej metody tylko wtedy, gdy FaceDetector jest tworzony 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 wykrywania twarzy. Podane sygnatury czasowe muszą rosnąć monotonicznie.

FaceDetector 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 FaceDetectorResult detectForVideo (obraz MPImage, ImageProcessingOptions imageProcessingOptions, long timestampMs)

Wykrywanie twarzy w podanej klatce wideo. Używaj tej metody tylko wtedy, gdy tworzony jest FaceDetector za pomocą ERROR(/RunningMode.VIDEO).

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

FaceDetector 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 FaceDetectorResult detectForVideo (obraz MPImage, długie sygnatury czasowe)

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

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

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