FaceDetector

genel final sınıfı FaceDetector

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
detect(MPImage resmi)
Sağlanan tek resimde, varsayılan resim işleme seçenekleriyle, yüz algılamayı gerçekleştirir.
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
detectAsync(MPImage resmi, uzun zaman damgaları)
Varsayılan görüntü işleme seçenekleriyle (ör.
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.