Memperkenalkan Google AI Edge Portal: Lakukan benchmark Edge AI dalam skala besar. Daftar untuk meminta akses selama pratinjau pribadi.

Halaman ini diterjemahkan oleh Cloud Translation API.

FaceDetector

class final publik FaceDetector

Melakukan deteksi wajah pada gambar.

API mengharapkan model TFLite dengan Metadata Model TFLite..

Gambar input MPImage
- Gambar yang menjalankan detektor wajah.
Output FaceDetectorResult FaceDetectorResult
- FaceDetectorResult yang berisi wajah yang terdeteksi.

Class Bertingkat

class FaceDetector.FaceDetectorOptions Opsi untuk menyiapkan FaceDetector.

Metode Publik

statis FaceDetector	createFromBuffer(Konteks konteks, modelBuffer ByteBuffer) Membuat instance `FaceDetector` dari buffering model dan `FaceDetector.FaceDetectorOptions` default.
statis FaceDetector	createFromFile(Konteks konteks, String modelPath) Membuat instance `FaceDetector` dari file model dan `FaceDetector.FaceDetectorOptions` default.
statis FaceDetector	createFromFile(Konteks konteks, File modelFile) Membuat instance `FaceDetector` dari file model dan `FaceDetector.FaceDetectorOptions` default.
statis FaceDetector	createFromOptions(Konteks konteks, FaceDetector.FaceDetectorOptions detektorOptions) Membuat instance `FaceDetector` dari `FaceDetector.FaceDetectorOptions`.
FaceDetectorResult	detect(gambar MPImage) Melakukan deteksi wajah pada satu gambar yang disediakan dengan opsi pemrosesan gambar default, yaitu
FaceDetectorResult	detect(gambar MPImage, ImageProcessingOptions imageProcessingOptions) Melakukan deteksi wajah pada satu gambar yang disediakan.
void	detectAsync(gambar MPImage, ImageProcessingOptions imageProcessingOptions, stempel waktu yang panjang) Mengirim data gambar live untuk melakukan deteksi wajah, dan hasilnya akan tersedia melalui `OutputHandler.ResultListener` yang disediakan di `FaceDetector.FaceDetectorOptions`.
void	detectAsync(gambar MPImage, timestampMs panjang) Mengirim data gambar live untuk melakukan deteksi wajah dengan opsi pemrosesan gambar default, yaitu
FaceDetectorResult	detectForVideo(gambar MPImage, ImageProcessingOptions imageProcessingOptions, stempel waktu yang panjang) Melakukan deteksi wajah pada frame video yang disediakan.
FaceDetectorResult	detectForVideo(gambar MPImage, timestampMs panjang) Melakukan deteksi wajah pada frame video yang disediakan dengan opsi pemrosesan gambar default, yaitu

Metode Turunan

Dari class com.google.mediapipe.tasks.vision.core.BaseVisionTaskApi

void	close() Menutup dan membersihkan tugas MediaPipe Vision.
statis panjang	generateResultTimestampMs(RunningMode runningMode, Paket paket) Menghasilkan stempel waktu objek hasil tugas vision dari mode tugas vision yang berjalan dan paket output.

Dari class java.lang.Object

boolean	sama dengan(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	wait()

Dari antarmuka java.lang.AutoCloseable

abstrak void

close()

Metode Publik

publik statis FaceDetector createFromBuffer (Konteks konteks, ByteBuffer modelBuffer)

Membuat instance FaceDetector dari buffering model dan FaceDetector.FaceDetectorOptions default.

Parameter

context	`ERROR(/Context)` Android.
modelBuffer	`ByteBuffer` atau `ERROR(/MappedByteBuffer)` langsung dari model deteksi.

Menampilkan

	jika terjadi error selama pembuatan `FaceDetector`.

public static FaceDetector createFromFile (Konteks konteks, String modelPath)

Membuat instance FaceDetector dari file model dan FaceDetector.FaceDetectorOptions default.

Parameter

context	`ERROR(/Context)` Android.
modelPath	ke model deteksi dengan metadata dalam aset.

Menampilkan

	jika terjadi error selama pembuatan `FaceDetector`.

public static FaceDetector createFromFile (Konteks konteks, File modelFile)

Membuat instance FaceDetector dari file model dan FaceDetector.FaceDetectorOptions default.

Parameter

context	`ERROR(/Context)` Android.
modelFile	instance `File` model deteksi.

Menampilkan

IOException	jika terjadi error I/O saat membuka file model tflite.
	jika terjadi error selama pembuatan `FaceDetector`.

public statis FaceDetector createFromOptions (Konteks konteks, FaceDetector.FaceDetectorOptions detektorOptions)

Membuat instance FaceDetector dari FaceDetector.FaceDetectorOptions.

Parameter

context	`ERROR(/Context)` Android.
detectorOptions	instance `FaceDetector.FaceDetectorOptions`.

Menampilkan

	jika terjadi error selama pembuatan `FaceDetector`.

publik FaceDetectorResult detect (gambar MPImage)

Melakukan deteksi wajah pada satu gambar yang disediakan dengan opsi pemrosesan gambar default, yaitu tanpa rotasi apa pun yang diterapkan. Hanya gunakan metode ini saat FaceDetector dibuat dengan ERROR(/RunningMode.IMAGE).

FaceDetector mendukung jenis ruang warna berikut:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

gambar	objek `MPImage` MediaPipe untuk diproses.

Menampilkan

	jika terjadi error internal.

publik FaceDetectorResult detect (MPImage gambar, ImageProcessingOptions imageProcessingOptions)

Melakukan deteksi wajah pada satu gambar yang disediakan. Hanya gunakan metode ini saat FaceDetector dibuat dengan ERROR(/RunningMode.IMAGE).

FaceDetector mendukung jenis ruang warna berikut:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

gambar	objek `MPImage` MediaPipe untuk diproses.
imageProcessingOptions	`ImageProcessingOptions` yang menentukan cara memproses gambar input sebelum menjalankan inferensi. Perlu diperhatikan bahwa region minat tidak didukung oleh tugas ini: menentukan `ImageProcessingOptions.regionOfInterest()` akan menyebabkan metode ini menampilkan IllegalArgumentException.

Menampilkan

IllegalArgumentException	jika `ImageProcessingOptions` menentukan wilayah minat.
	jika terjadi error internal.

public void detectAsync (Gambar MPImage, ImageProcessingOptions imageProcessingOptions, stempel waktu yang panjang)

Mengirim data gambar live untuk melakukan deteksi wajah, dan hasilnya akan tersedia melalui OutputHandler.ResultListener yang disediakan di FaceDetector.FaceDetectorOptions. Hanya gunakan metode ini saat FaceDetector dibuat dengan ERROR(/RunningMode.LIVE_STREAM).

Stempel waktu (dalam milidetik) harus diberikan untuk menunjukkan kapan gambar input dikirim ke detektor wajah. Stempel waktu input harus meningkat secara monoton.

FaceDetector mendukung jenis ruang warna berikut:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

gambar	objek `MPImage` MediaPipe untuk diproses.
imageProcessingOptions	`ImageProcessingOptions` yang menentukan cara memproses gambar input sebelum menjalankan inferensi. Perlu diperhatikan bahwa region minat tidak didukung oleh tugas ini: menentukan `ImageProcessingOptions.regionOfInterest()` akan menyebabkan metode ini menampilkan IllegalArgumentException.
timestampMs	stempel waktu input (dalam milidetik).

Menampilkan

IllegalArgumentException	jika `ImageProcessingOptions` menentukan wilayah minat.
	jika terjadi error internal.

public void detectAsync (gambar MPImage, timestampMs panjang)

Mengirim data gambar live untuk melakukan deteksi wajah dengan opsi pemrosesan gambar default, yaitu tanpa penerapan rotasi apa pun, dan hasilnya akan tersedia melalui OutputHandler.ResultListener yang disediakan di FaceDetector.FaceDetectorOptions. Hanya gunakan metode ini jika FaceDetector dibuat dengan ERROR(/RunningMode.LIVE_STREAM).

Stempel waktu (dalam milidetik) harus diberikan untuk menunjukkan kapan gambar input dikirim ke detektor wajah. Stempel waktu input harus meningkat secara monoton.

FaceDetector mendukung jenis ruang warna berikut:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

gambar	objek `MPImage` MediaPipe untuk diproses.
timestampMs	stempel waktu input (dalam milidetik).

Menampilkan

	jika terjadi error internal.

publik FaceDetectorResult detectForVideo (MPImage gambar, ImageProcessingOptions imageProcessingOptions, stempel waktu yang panjangMs)

Melakukan deteksi wajah pada frame video yang disediakan. Hanya gunakan metode ini saat FaceDetector dibuat dengan ERROR(/RunningMode.VIDEO).

Anda harus memberikan stempel waktu frame video (dalam milidetik). Stempel waktu input harus meningkat secara monoton.

FaceDetector mendukung jenis ruang warna berikut:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

gambar	objek `MPImage` MediaPipe untuk diproses.
imageProcessingOptions	`ImageProcessingOptions` yang menentukan cara memproses gambar input sebelum menjalankan inferensi. Perlu diperhatikan bahwa region minat tidak didukung oleh tugas ini: menentukan `ImageProcessingOptions.regionOfInterest()` akan menyebabkan metode ini menampilkan IllegalArgumentException.
timestampMs	stempel waktu input (dalam milidetik).

Menampilkan

IllegalArgumentException	jika `ImageProcessingOptions` menentukan wilayah minat.
	jika terjadi error internal.

publik FaceDetectorResult detectForVideo (gambar MPImage, timestampMs yang panjang)

Melakukan deteksi wajah pada frame video yang disediakan dengan opsi pemrosesan gambar default, yaitu tanpa menerapkan rotasi apa pun. Hanya gunakan metode ini jika FaceDetector dibuat dengan ERROR(/RunningMode.VIDEO).

Anda harus memberikan stempel waktu frame video (dalam milidetik). Stempel waktu input harus meningkat secara monoton.

FaceDetector mendukung jenis ruang warna berikut:

ERROR(/Bitmap.Config.ARGB_8888)

Parameter

gambar	objek `MPImage` MediaPipe untuk diproses.
timestampMs	stempel waktu input (dalam milidetik).

Menampilkan

	jika terjadi error internal.