FaceLandmarker

kelas final publik FaceLandmarker

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
FaceLandmarkerResult
detect(gambar MPImage)
Melakukan deteksi tempat terkenal wajah pada satu gambar yang disediakan dengan opsi pemrosesan gambar default, yaitu
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

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 Tetapkan<Koneksi> 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 Tetapkan<Koneksi> FACE_LANDMARKS_RIGHT_EYE_BROW

public static final Set<Connection> FACE_LANDMARKS_RIGHT_IRIS

public static final Set<Connection> FACE_LANDMARKS_TESSELATION

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)

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.