Görüntülerde yüzlerin önemli noktalarını algılama özelliğini gerçekleştirir.
Bu API, önceden eğitilmiş bir yüz önemli noktaları modeli öğe paketi gerektirir. Bkz.
- Giriş resmi
MPImage- Yüzle ilgili önemli noktalar algılama özelliğinin çalıştığı görüntü.
- Çıkış
FaceLandmarkerResult- Yüz yer işaretlerini içeren bir FaceLandmarkerResult.
İç İçe Sınıflar
| sınıf | FaceLandmarker.FaceLandmarkerOptions | FaceLandmarker ayarlama seçenekleri. |
|
Alanlar
| herkese açık static final Set<Connection> | FACE_LANDMARKS_CONNECTORS | |
| herkese açık static final Set<Connection> | FACE_LANDMARKS_FACE_OVAL | |
| herkese açık static final Set<Connection> | FACE_LANDMARKS_LEFT_EYE | |
| herkese açık static final Set<Connection> | FACE_LANDMARKS_LEFT_EYE_BROW | |
| herkese açık static final Set<Connection> | FACE_LANDMARKS_LEFT_IRIS | |
| herkese açık static final Set<Connection> | FACE_LANDMARKS_LIPS | |
| herkese açık static final Set<Connection> | FACE_LANDMARKS_RIGHT_EYE | |
| herkese açık static final Set<Connection> | FACE_LANDMARKS_RIGHT_EYE_BROW | |
| herkese açık static final Set<Connection> | FACE_LANDMARKS_RIGHT_IRIS | |
| herkese açık static final Set<Connection> | FACE_LANDMARKS_TESSELATION |
Herkese Açık Yöntemler
| statik FaceLandmarker |
createFromBuffer(Bağlam bağlamı, ByteBuffer modelAssetBuffer)
Model öğe paketi arabelleğinden ve varsayılan
FaceLandmarker.FaceLandmarkerOptions öğesinden bir FaceLandmarker örneği oluşturur. |
| statik FaceLandmarker |
createFromFile(Bağlam bağlamı, Dize modelAssetPath)
Model öğe paketi yolundan ve varsayılan
FaceLandmarker.FaceLandmarkerOptions öğesinden FaceLandmarker örneği oluşturur. |
| statik FaceLandmarker |
createFromFile(Bağlam bağlamı, Dosya modelAssetFile)
Bir model öğesi paket dosyasından
FaceLandmarker örneği ve varsayılan FaceLandmarker.FaceLandmarkerOptions oluşturur. |
| statik FaceLandmarker |
createFromOptions(Bağlam bağlamı, FaceLandmarker.FaceLandmarkerOptions markerOptions)
FaceLandmarker.FaceLandmarkerOptions öğesinden FaceLandmarker örneği oluşturur. |
| FaceLandmarkerResult | |
| FaceLandmarkerResult |
detect(MPImage resmi, ImageProcessingOptions imageProcessingOptions)
Sağlanan tek resimde yüzlerin önemli noktalarını algılamayı gerçekleştirir.
|
| void |
detectAsync(MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun zaman damgaları)
Yüzlerin önemli noktalarını algılamak için canlı resim verileri gönderir. Sonuçlar,
FaceLandmarker.FaceLandmarkerOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla kullanıma sunulur. |
| void |
detectAsync(MPImage resmi, uzun zaman damgaları)
Yüzlerin önemli noktalarını algılamak için varsayılan görüntü işleme seçenekleriyle (ör.
|
| FaceLandmarkerResult |
detectForVideo(MPImage resmi, ImageProcessingOptions imageProcessingOptions, uzun zaman damgaları)
Sağlanan video karesinde yüzlerin önemli noktalarını algılamayı gerçekleştirir.
|
| FaceLandmarkerResult |
detectForVideo(MPImage resmi, uzun zaman damgaları)
Sağlanan video karesinde varsayılan resim işleme seçeneklerini kullanarak yüzlerin önemli noktalarını algılamasını
gerçekleştirir.
|
Devralınan Yöntemler
Alanlar
Herkese Açık Yöntemler
herkese açık statik FaceLandmarker createFromBuffer (Bağlam bağlamı, ByteBuffer modelAssetBuffer)
Model öğe paketi arabelleğinden ve varsayılan FaceLandmarker.FaceLandmarkerOptions öğesinden bir FaceLandmarker örneği oluşturur.
Parametreler
| context | Android ERROR(/Context). |
|---|---|
| modelAssetBuffer |
Dekoratif yastıklar
FaceLandmarker oluşturulurken bir hata meydana gelirse.
|
herkese açık static FaceLandmarker createFromFile (Bağlam bağlamı, Dize modelAssetPath)
Model öğe paketi yolundan ve varsayılan FaceLandmarker.FaceLandmarkerOptions öğesinden FaceLandmarker örneği oluşturur.
Parametreler
| context | Android ERROR(/Context). |
|---|---|
| modelAssetPath | öğelerde meta veriler içeren yüz yer işaretleri modeline giden yol. |
Dekoratif yastıklar
FaceLandmarker oluşturulurken bir hata meydana gelirse.
|
herkese açık statik FaceLandmarker createFromFile (Bağlam bağlamı, Dosya modelAssetFile)
Bir model öğesi paket dosyasından FaceLandmarker örneği ve varsayılan FaceLandmarker.FaceLandmarkerOptions oluşturur.
Parametreler
| context | Android ERROR(/Context). |
|---|---|
| modelAssetFile | yüz yer işaretleri model File örneği. |
Dekoratif yastıklar
| IOException | tflite model dosyası açılırken bir G/Ç hatası oluşursa. |
|---|---|
FaceLandmarker oluşturulurken bir hata meydana gelirse.
|
herkese açık static FaceLandmarker createFromOptions (Bağlam bağlamı, FaceLandmarker.FaceLandmarkerOptions işareterSeçenekleri)
FaceLandmarker.FaceLandmarkerOptions öğesinden FaceLandmarker örneği oluşturur.
Parametreler
| context | Android ERROR(/Context). |
|---|---|
| landmarkerOptions | FaceLandmarker.FaceLandmarkerOptions örneği. |
Dekoratif yastıklar
FaceLandmarker oluşturulurken bir hata meydana gelirse.
|
herkese açık FaceLandmarkerResult detect (MPImage görüntüsü)
Sağlanan tekli resimde, varsayılan resim işleme seçenekleriyle (yani herhangi bir döndürme uygulanmadan) yüzlerin önemli noktalarını algılamayı gerçekleştirir. Bu yöntemi yalnızca FaceLandmarker, ERROR(/RunningMode.IMAGE) ile oluşturulduğunda kullanın. YAPILACAKLAR, giriş resim biçimi için Java dokümanını
güncelleme.
FaceLandmarker, aşağıdaki renk alanı türlerini destekler:
Parametreler
| resim | İşlenmek üzere bir MediaPipe MPImage nesnesi. |
|---|
Dekoratif yastıklar
| dahili hata olup olmadığını kontrol edin. |
herkese açık FaceLandmarkerResult detect (MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions)
Sağlanan tek resimde yüzlerin önemli noktalarını algılamayı gerçekleştirir. Bu yöntemi yalnızca FaceLandmarker, ERROR(/RunningMode.IMAGE) ile oluşturulduğunda kullanın. TODO girişi resim biçimi için Java dokümanını güncelleyin.
FaceLandmarker, aşağıdaki renk alanı türlerini destekler:
Parametreler
| resim | İşlenmek üzere bir MediaPipe MPImage nesnesi. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions bağımsız değişkeni, çıkarımı çalıştırmadan önce giriş görüntüsünün nasıl işleneceğini belirtir. Bu görev, ilgi bölgesinin desteklenmediğini unutmayın: ImageProcessingOptions.regionOfInterest() belirtilmesi bu yöntemin bir Yasa DışıArgumentException döndürülmesine neden olur. |
Dekoratif yastıklar
| IllegalArgumentException | ImageProcessingOptions bir ilgi bölgesi belirtiyorsa |
|---|---|
| dahili hata olup olmadığını kontrol edin. |
herkese açık void detectAsync (MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun timestampM'ler)
Yüzlerin önemli noktalarını algılamak için canlı resim verileri gönderir. Sonuçlar, FaceLandmarker.FaceLandmarkerOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla kullanıma sunulur. Bu yöntemi yalnızca FaceLandmarker, ERROR(/RunningMode.LIVE_STREAM) ile oluşturulduğunda kullanın.
Giriş görüntüsünün yüz işaretçisine ne zaman gönderildiğini belirtmek için bir zaman damgası (milisaniye cinsinden) sağlanması gerekir. Giriş zaman damgaları tekdüze şekilde artmalıdır.
FaceLandmarker, aşağıdaki renk alanı türlerini destekler:
Parametreler
| resim | İşlenmek üzere bir MediaPipe MPImage nesnesi. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions bağımsız değişkeni, çıkarımı çalıştırmadan önce giriş görüntüsünün nasıl işleneceğini belirtir. Bu görev, ilgi bölgesinin desteklenmediğini unutmayın: ImageProcessingOptions.regionOfInterest() belirtilmesi bu yöntemin bir Yasa DışıArgumentException döndürülmesine neden olur. |
| timestampMs | giriş zaman damgası (milisaniye cinsinden). |
Dekoratif yastıklar
| IllegalArgumentException | ImageProcessingOptions bir ilgi bölgesi belirtiyorsa |
|---|---|
| dahili hata olup olmadığını kontrol edin. |
herkese açık void detectAsync (MPImage resmi, uzun timestampMs)
Varsayılan resim işleme seçenekleriyle (yani herhangi bir rotasyon uygulanmadan) yüzlerin önemli noktalarını algılamak için canlı resim verilerini gönderir ve sonuçlar, FaceLandmarker.FaceLandmarkerOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla sunulur. Bu yöntemi yalnızca FaceLandmarker, ERROR(/RunningMode.LIVE_STREAM) ile oluşturulduğunda kullanın.
Giriş görüntüsünün yüz işaretçisine ne zaman gönderildiğini belirtmek için bir zaman damgası (milisaniye cinsinden) sağlanması gerekir. Giriş zaman damgaları tekdüze şekilde artmalıdır.
FaceLandmarker, aşağıdaki renk alanı türlerini destekler:
Parametreler
| resim | İşlenmek üzere bir MediaPipe MPImage nesnesi. |
|---|---|
| timestampMs | giriş zaman damgası (milisaniye cinsinden). |
Dekoratif yastıklar
| dahili hata olup olmadığını kontrol edin. |
herkese açık FaceLandmarkerResult detectForVideo (MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun zaman damgaları)
Sağlanan video karesinde yüzlerin önemli noktalarını algılamayı gerçekleştirir. Bu yöntemi yalnızca FaceLandmarker, ERROR(/RunningMode.VIDEO) ile oluşturulduğunda kullanın.
Video karesinin zaman damgasını (milisaniye cinsinden) sağlamanız gerekir. Giriş zaman damgaları tekdüze şekilde artmalıdır.
FaceLandmarker, aşağıdaki renk alanı türlerini destekler:
Parametreler
| resim | İşlenmek üzere bir MediaPipe MPImage nesnesi. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions bağımsız değişkeni, çıkarımı çalıştırmadan önce giriş görüntüsünün nasıl işleneceğini belirtir. Bu görev, ilgi bölgesinin desteklenmediğini unutmayın: ImageProcessingOptions.regionOfInterest() belirtilmesi bu yöntemin bir Yasa DışıArgumentException döndürülmesine neden olur. |
| timestampMs | giriş zaman damgası (milisaniye cinsinden). |
Dekoratif yastıklar
| IllegalArgumentException | ImageProcessingOptions bir ilgi bölgesi belirtiyorsa |
|---|---|
| dahili hata olup olmadığını kontrol edin. |
herkese açık FaceLandmarkerResult detectForVideo (MPImage resmi, uzun zaman damgaları)
Sağlanan video karesinde varsayılan resim işleme seçenekleriyle (yani herhangi bir döndürme uygulanmadan) yüz önemli noktalarını algılamayı gerçekleştirir. Bu yöntemi yalnızca FaceLandmarker, ERROR(/RunningMode.VIDEO) ile oluşturulduğunda kullanın.
Video karesinin zaman damgasını (milisaniye cinsinden) sağlamanız gerekir. Giriş zaman damgaları tekdüze şekilde artmalıdır.
FaceLandmarker, aşağıdaki renk alanı türlerini destekler:
Parametreler
| resim | İşlenmek üzere bir MediaPipe MPImage nesnesi. |
|---|---|
| timestampMs | giriş zaman damgası (milisaniye cinsinden). |
Dekoratif yastıklar
| dahili hata olup olmadığını kontrol edin. |