Melakukan deteksi penanda wajah pada gambar.
API ini mengharapkan paket aset model penanda wajah terlatih. Lihat
- Gambar input
MPImage
- Gambar yang menjalankan deteksi tempat terkenal wajah.
- Output
FaceLandmarkerResult
- FaceLandmarkerResult yang berisi penanda wajah.
Class Bertingkat
class | FaceLandmarker.FaceLandmarkerOptions | Opsi untuk menyiapkan FaceLandmarker . |
Kolom
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 |
Metode Publik
statis FaceLandmarker |
createFromBuffer(Konteks konteks, ByteBuffer modelAssetBuffer)
Membuat instance
FaceLandmarker dari buffer paket aset model dan FaceLandmarker.FaceLandmarkerOptions default. |
statis FaceLandmarker |
createFromFile(Konteks konteks, String modelAssetPath)
Membuat instance
FaceLandmarker dari jalur paket aset model dan FaceLandmarker.FaceLandmarkerOptions default. |
statis FaceLandmarker |
createFromFile(Konteks konteks, File modelAssetFile)
Membuat instance
FaceLandmarker dari file paket aset model dan FaceLandmarker.FaceLandmarkerOptions default. |
statis FaceLandmarker |
createFromOptions(Konteks konteks, FaceLandmarker.FaceLandmarkerOptions penandaerOptions)
Membuat instance
FaceLandmarker dari FaceLandmarker.FaceLandmarkerOptions . |
FaceLandmarkerResult | |
FaceLandmarkerResult |
detect(gambar MPImage, ImageProcessingOptions imageProcessingOptions)
Melakukan deteksi penanda wajah pada satu gambar yang disediakan.
|
void |
detectAsync(gambar MPImage, ImageProcessingOptions imageProcessingOptions, stempel waktu yang panjang)
Mengirim data gambar live untuk melakukan deteksi tempat terkenal wajah, dan hasilnya akan tersedia melalui
OutputHandler.ResultListener yang disediakan di FaceLandmarker.FaceLandmarkerOptions . |
void |
detectAsync(gambar MPImage, timestampMs panjang)
Mengirim data gambar live untuk melakukan deteksi tempat terkenal wajah dengan opsi pemrosesan gambar default, yaitu
|
FaceLandmarkerResult |
detectForVideo(gambar MPImage, ImageProcessingOptions imageProcessingOptions, stempel waktu yang panjang)
Melakukan deteksi penanda wajah pada frame video yang disediakan.
|
FaceLandmarkerResult |
detectForVideo(gambar MPImage, timestampMs panjang)
Melakukan deteksi tempat terkenal wajah pada frame video yang disediakan dengan opsi pemrosesan gambar default, yaitu
|
Metode Turunan
Kolom
Metode Publik
publik statis FaceLandmarker createFromBuffer (Konteks konteks, ByteBuffer modelAssetBuffer)
Membuat instance FaceLandmarker
dari buffer paket aset model dan FaceLandmarker.FaceLandmarkerOptions
default.
Parameter
context | ERROR(/Context) Android. |
---|---|
modelAssetBuffer |
Menampilkan
jika terjadi error selama pembuatan FaceLandmarker .
|
publik statis FaceLandmarker createFromFile (Konteks konteks, String modelAssetPath)
Membuat instance FaceLandmarker
dari jalur paket aset model dan FaceLandmarker.FaceLandmarkerOptions
default.
Parameter
context | ERROR(/Context) Android. |
---|---|
modelAssetPath | ke model tempat terkenal wajah dengan metadata dalam aset. |
Menampilkan
jika terjadi error selama pembuatan FaceLandmarker .
|
publik statis FaceLandmarker createFromFile (Konteks konteks, File modelAssetFile)
Membuat instance FaceLandmarker
dari file paket aset model dan FaceLandmarker.FaceLandmarkerOptions
default.
Parameter
context | ERROR(/Context) Android. |
---|---|
modelAssetFile | instance File model penanda wajah. |
Menampilkan
IOException | jika terjadi error I/O saat membuka file model tflite. |
---|---|
jika terjadi error selama pembuatan FaceLandmarker .
|
public statis FaceLandmarker createFromOptions (Konteks konteks, FaceLandmarker.FaceLandmarkerOptions penandaerOptions)
Membuat instance FaceLandmarker
dari FaceLandmarker.FaceLandmarkerOptions
.
Parameter
context | ERROR(/Context) Android. |
---|---|
landmarkerOptions | instance FaceLandmarker.FaceLandmarkerOptions . |
Menampilkan
jika terjadi error selama pembuatan FaceLandmarker .
|
publik FaceLandmarkerResult detect (gambar MPImage)
Melakukan deteksi tempat terkenal wajah pada satu gambar yang disediakan dengan opsi pemrosesan gambar default, yaitu tanpa rotasi yang diterapkan. Hanya gunakan metode ini saat FaceLandmarker
dibuat dengan ERROR(/RunningMode.IMAGE)
. TODO memperbarui dokumen java
untuk format gambar input.
FaceLandmarker
mendukung jenis ruang warna berikut:
Parameter
gambar | objek MPImage MediaPipe untuk diproses. |
---|
Menampilkan
jika terjadi error internal. |
publik FaceLandmarkerResult detect (MPImage gambar, ImageProcessingOptions imageProcessingOptions)
Melakukan deteksi penanda wajah pada satu gambar yang disediakan. Hanya gunakan metode ini jika FaceLandmarker
dibuat dengan ERROR(/RunningMode.IMAGE)
. TODO memperbarui dokumen
java untuk format gambar input.
FaceLandmarker
mendukung jenis ruang warna berikut:
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 tempat terkenal wajah, dan hasilnya akan tersedia melalui OutputHandler.ResultListener
yang disediakan di FaceLandmarker.FaceLandmarkerOptions
. Hanya gunakan metode ini jika FaceLandmarker
dibuat dengan ERROR(/RunningMode.LIVE_STREAM)
.
Anda harus memberikan stempel waktu (dalam milidetik) untuk menunjukkan kapan gambar input dikirim ke penanda wajah. Stempel waktu input harus meningkat secara monoton.
FaceLandmarker
mendukung jenis ruang warna berikut:
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 tempat terkenal wajah dengan opsi pemrosesan gambar default, yaitu tanpa penerapan rotasi apa pun, dan hasilnya akan tersedia melalui OutputHandler.ResultListener
yang disediakan di FaceLandmarker.FaceLandmarkerOptions
. Hanya gunakan metode ini jika FaceLandmarker
dibuat dengan ERROR(/RunningMode.LIVE_STREAM)
.
Anda harus memberikan stempel waktu (dalam milidetik) untuk menunjukkan kapan gambar input dikirim ke penanda wajah. Stempel waktu input harus meningkat secara monoton.
FaceLandmarker
mendukung jenis ruang warna berikut:
Parameter
gambar | objek MPImage MediaPipe untuk diproses. |
---|---|
timestampMs | stempel waktu input (dalam milidetik). |
Menampilkan
jika terjadi error internal. |
publik FaceLandmarkerResult detectForVideo (gambar MPImage, ImageProcessingOptions imageProcessingOptions, stempel waktu yang panjangMs)
Melakukan deteksi penanda wajah pada frame video yang disediakan. Hanya gunakan metode ini jika FaceLandmarker
dibuat dengan ERROR(/RunningMode.VIDEO)
.
Anda harus memberikan stempel waktu frame video (dalam milidetik). Stempel waktu input harus meningkat secara monoton.
FaceLandmarker
mendukung jenis ruang warna berikut:
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 FaceLandmarkerResult detectForVideo (gambar MPImage, timestampMs yang panjang)
Melakukan deteksi tempat terkenal wajah pada frame video yang disediakan dengan opsi pemrosesan gambar default, yaitu tanpa rotasi yang diterapkan. Hanya gunakan metode ini saat FaceLandmarker
dibuat dengan ERROR(/RunningMode.VIDEO)
.
Anda harus memberikan stempel waktu frame video (dalam milidetik). Stempel waktu input harus meningkat secara monoton.
FaceLandmarker
mendukung jenis ruang warna berikut:
Parameter
gambar | objek MPImage MediaPipe untuk diproses. |
---|---|
timestampMs | stempel waktu input (dalam milidetik). |
Menampilkan
jika terjadi error internal. |