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