Görüntülerde yüz algılamayı gerçekleştirir.
API, TFLite Model Meta Verileri içeren bir TFLite modeli bekler.
- Giriş resmi
MPImage- Yüz algılayıcının üzerinde çalıştığı görüntü.
- FaceDetectorResult
FaceDetectorResultçıkışı- Algılanan yüzleri içeren bir FaceDetectorResult.
İç İçe Sınıflar
| sınıf | FaceDetector.FaceDetectorOptions | FaceDetector ayarlama seçenekleri. |
|
Herkese Açık Yöntemler
| static FaceDetector |
createFromBuffer(Bağlam bağlamı, ByteBuffer modelBuffer)
Model arabelleğinden ve varsayılan
FaceDetector.FaceDetectorOptions öğesinden FaceDetector örneği oluşturur. |
| static FaceDetector |
createFromFile(Bağlam bağlamı, Dize modelPath)
Model dosyasından
FaceDetector örneği ve varsayılan FaceDetector.FaceDetectorOptions oluşturur. |
| static FaceDetector |
createFromFile(Bağlam bağlamı, Dosya modelFile)
Model dosyasından
FaceDetector örneği ve varsayılan FaceDetector.FaceDetectorOptions oluşturur. |
| static FaceDetector |
createFromOptions(Bağlam içeriği, FaceDetector.FaceDetectorOptionsdetectorOptions)
FaceDetector.FaceDetectorOptions öğesinden FaceDetector örneği oluşturur. |
| FaceDetectorResult | |
| FaceDetectorResult |
detect(MPImage resmi, ImageProcessingOptions imageProcessingOptions)
Sağlanan tek resimde yüz algılamayı gerçekleştirir.
|
| void |
detectAsync(MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun zaman damgaları)
Yüz algılama işlemi gerçekleştirmek için canlı görüntü verilerini gönderir. Sonuçlar,
FaceDetector.FaceDetectorOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla kullanıma sunulur. |
| void | |
| FaceDetectorResult |
detectForVideo(MPImage resmi, ImageProcessingOptions imageProcessingOptions, uzun zaman damgaları)
Sağlanan video karesinde yüz algılamayı gerçekleştirir.
|
| FaceDetectorResult |
detectForVideo(MPImage resmi, uzun zaman damgaları)
Sağlanan video karesinde varsayılan resim işleme seçenekleriyle (ör.
|
Devralınan Yöntemler
Herkese Açık Yöntemler
herkese açık statik FaceDetector createFromBuffer (Bağlam bağlamı, ByteBuffer modelBuffer)
Model arabelleğinden ve varsayılan FaceDetector.FaceDetectorOptions öğesinden FaceDetector örneği oluşturur.
Parametreler
| context | Android ERROR(/Context). |
|---|---|
| modelBuffer | algılama modelinin doğrudan ByteBuffer veya ERROR(/MappedByteBuffer) değeri. |
Dekoratif yastıklar
FaceDetector oluşturulurken bir hata meydana gelirse.
|
herkese açık static FaceDetector createFromFile (Bağlam içeriği, Dize modelPath)
Model dosyasından FaceDetector örneği ve varsayılan FaceDetector.FaceDetectorOptions oluşturur.
Parametreler
| context | Android ERROR(/Context). |
|---|---|
| modelPath | meta veri içeren algılama modeline giden bir yoldur. |
Dekoratif yastıklar
FaceDetector oluşturulurken bir hata meydana gelirse.
|
herkese açık static FaceDetector createFromFile (Bağlam bağlamı, Dosya modelFile)
Model dosyasından FaceDetector örneği ve varsayılan FaceDetector.FaceDetectorOptions oluşturur.
Parametreler
| context | Android ERROR(/Context). |
|---|---|
| modelFile | algılama modeli File örneğine bakalım. |
Dekoratif yastıklar
| IOException | tflite model dosyası açılırken bir G/Ç hatası oluşursa. |
|---|---|
FaceDetector oluşturulurken bir hata meydana gelirse.
|
herkese açık static FaceDetector createFromOptions (Bağlam bağlamı, FaceDetector.FaceDetectorOptionsdetectorOptions)
FaceDetector.FaceDetectorOptions öğesinden FaceDetector örneği oluşturur.
Parametreler
| context | Android ERROR(/Context). |
|---|---|
| detectorOptions | FaceDetector.FaceDetectorOptions örneği. |
Dekoratif yastıklar
FaceDetector oluşturulurken bir hata meydana gelirse.
|
herkese açık FaceDetectorResult detect (MPImage resmi)
Sağlanan tek resimde, varsayılan resim işleme seçenekleriyle, yani döndürme uygulanmadan yüz algılamayı gerçekleştirir. Bu yöntemi yalnızca FaceDetector, ERROR(/RunningMode.IMAGE) ile oluşturulduğunda kullanın.
FaceDetector, 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 FaceDetectorResult detect (MPImage resmi, ImageProcessingOptions imageProcessingOptions)
Sağlanan tek resimde yüz algılamayı gerçekleştirir. Bu yöntemi yalnızca FaceDetector, ERROR(/RunningMode.IMAGE) ile oluşturulduğunda kullanın.
FaceDetector, 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üz algılama işlemi gerçekleştirmek için canlı görüntü verilerini gönderir. Sonuçlar, FaceDetector.FaceDetectorOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla kullanıma sunulur. Bu yöntemi yalnızca FaceDetector, ERROR(/RunningMode.LIVE_STREAM) ile oluşturulduğunda kullanın.
Giriş görüntüsünün yüz algılayıcıya ne zaman gönderildiğini belirtmek için bir zaman damgası (milisaniye cinsinden) sağlamanız gerekir. Giriş zaman damgaları tekdüze şekilde artmalıdır.
FaceDetector, 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 döndürme uygulanmadan) yüz algılama yapmak için canlı resim verilerini gönderir ve sonuçlar, FaceDetector.FaceDetectorOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla sunulur. Bu yöntemi yalnızca FaceDetector, ERROR(/RunningMode.LIVE_STREAM) ile oluşturulduğunda kullanın.
Giriş görüntüsünün yüz algılayıcıya ne zaman gönderildiğini belirtmek için bir zaman damgası (milisaniye cinsinden) sağlamanız gerekir. Giriş zaman damgaları tekdüze şekilde artmalıdır.
FaceDetector, 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 FaceDetectorResult detectForVideo (MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun timestampM'ler)
Sağlanan video karesinde yüz algılamayı gerçekleştirir. Bu yöntemi yalnızca FaceDetector, 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.
FaceDetector, 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 FaceDetectorResult detectForVideo (MPImage resmi, uzun zaman damgaları)
Sağlanan video karesinde varsayılan resim işleme seçenekleriyle, yani döndürme uygulanmadan yüz algılamayı gerçekleştirir. Bu yöntemi yalnızca FaceDetector, 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.
FaceDetector, 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. |