ObjectDetector

genel final sınıfı ObjectDetector

Görüntülerde nesne algılamayı gerçekleştirir.

API, TFLite Model Meta Verileri içeren bir TFLite modeli bekler.

API, bir görüntü giriş tensörüne ve dört çıkış tensörüne sahip modelleri destekler. Daha net olmak gerekirse gereksinimler şunlardır.

  • Giriş resmi tensörü (kTfLiteUInt8/kTfLiteFloat32)
    • [batch x height x width x channels] boyutunda resim girişi.
    • toplu çıkarım desteklenmiyor (batch değerinin 1 olması gerekir).
    • yalnızca RGB girişleri desteklenir (channels değerinin 3 olması gerekir).
    • tür kTfLiteFloat32 ise giriş normalleştirmesi için meta verilere NormalizationOptions eklenmelidir.
  • Çıkış tensörleri, bir DetectionPostProcess işleminin 4 çıkışı olmalıdır.Diğer bir deyişle:
    • Konum tensörü (kTfLiteFloat32):
      • [top, left, right, bottom] biçimindeki sınırlayıcı kutuları temsil eden iç dizi olan [1 x num_results x 4] boyutlu tensör.
      • BoundingBoxProperties meta verilere eklenmeli, type=BOUNDARIES ve coordinate_type=RATIO belirtilmelidir.
    • Sınıf tensörü (kTfLiteFloat32):
      • Her değer, bir sınıfın tam sayı dizinini temsil eden [1 x num_results] boyut tensörü.
      • Etiket eşlemeleri meta verilere TENSOR_VALUE_LABELS ilişkili dosyaları olarak eklenirse tensör değerlerini etiketlere dönüştürmek için kullanılır.
    • puanlar tensörü (kTfLiteFloat32):
      • [1 x num_results] boyut tensörü. Her değer, algılanan nesnenin puanını temsil eder.
    • Algılama tensörü sayısı (kTfLiteFloat32):
      • [1] boyutunda tensör olarak tamsayı num_results.

Bu modelin bir örneğini TensorFlow Hub'da bulabilirsiniz.

İç İçe Sınıflar

sınıf ObjectDetector.ObjectDetectorOptions ObjectDetector ayarlama seçenekleri. 

Herkese Açık Yöntemler

static ObjectDetector
createFromBuffer(Bağlam bağlamı, ByteBuffer modelBuffer)
Model arabelleğinden ve varsayılan ObjectDetector.ObjectDetectorOptions öğesinden ObjectDetector örneği oluşturur.
static ObjectDetector
createFromFile(Bağlam bağlamı, Dize modelPath)
Model dosyasından ObjectDetector örneği ve varsayılan ObjectDetector.ObjectDetectorOptions oluşturur.
static ObjectDetector
createFromFile(Bağlam bağlamı, Dosya modelFile)
Model dosyasından ObjectDetector örneği ve varsayılan ObjectDetector.ObjectDetectorOptions oluşturur.
static ObjectDetector
createFromOptions(Bağlam bağlamı, ObjectDetector.ObjectDetectorOptions algılayıcıSeçenekleri)
Bir ObjectDetector.ObjectDetectorOptions öğesinden ObjectDetector örneği oluşturur.
ObjectDetectorResult
detect(MPImage resmi)
Sağlanan tekli görüntü üzerinde, varsayılan görüntü işleme seçenekleriyle (ör.
ObjectDetectorResult
detect(MPImage resmi, ImageProcessingOptions imageProcessingOptions)
Sağlanan tekli resimde nesne algılamayı gerçekleştirir.
void
detectAsync(MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun zaman damgaları)
Nesne algılama işlemi gerçekleştirmek için canlı görüntü verilerini gönderir. Sonuçlar, ObjectDetector.ObjectDetectorOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla kullanılabilir.
void
detectAsync(MPImage resmi, uzun zaman damgaları)
Varsayılan görüntü işleme seçenekleriyle (ör.
ObjectDetectorResult
detectForVideo(MPImage resmi, ImageProcessingOptions imageProcessingOptions, uzun zaman damgaları)
Sağlanan video karesinde nesne algılamayı gerçekleştirir.
ObjectDetectorResult
detectForVideo(MPImage resmi, uzun zaman damgaları)
Varsayılan görüntü işleme seçeneklerini kullanarak, sağlanan video karesinde nesne algılamayı gerçekleştirir.

Devralınan Yöntemler

Herkese Açık Yöntemler

herkese açık statik ObjectDetector createFromBuffer (Bağlam bağlamı, ByteBuffer modelBuffer)

Model arabelleğinden ve varsayılan ObjectDetector.ObjectDetectorOptions öğesinden ObjectDetector örneği oluşturur.

Parametreler
context Android ERROR(/Context).
modelBuffer algılama modelinin doğrudan ByteBuffer veya ERROR(/MappedByteBuffer) değeri.
Dekoratif yastıklar
ObjectDetector oluşturulurken bir hata meydana gelirse.

herkese açık static ObjectDetector createFromFile (Bağlam içeriği, Dize modelPath)

Model dosyasından ObjectDetector örneği ve varsayılan ObjectDetector.ObjectDetectorOptions oluşturur.

Parametreler
context Android ERROR(/Context).
modelPath meta veri içeren algılama modeline giden bir yoldur.
Dekoratif yastıklar
ObjectDetector oluşturulurken bir hata meydana gelirse.

herkese açık static ObjectDetector createFromFile (Bağlam bağlamı, Dosya modelFile)

Model dosyasından ObjectDetector örneği ve varsayılan ObjectDetector.ObjectDetectorOptions 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.
ObjectDetector oluşturulurken bir hata meydana gelirse.

herkese açık static ObjectDetector createFromOptions (Bağlam içeriği, ObjectDetector.ObjectDetectorOptionsdetectorOptions)

Bir ObjectDetector.ObjectDetectorOptions öğesinden ObjectDetector örneği oluşturur.

Parametreler
context Android ERROR(/Context).
detectorOptions ObjectDetector.ObjectDetectorOptions örneği.
Dekoratif yastıklar
ObjectDetector oluşturulurken bir hata meydana gelirse.

herkese açık ObjectDetectorResult detect (MPImage görüntüsü)

Sağlanan tek resimde, varsayılan resim işleme seçenekleriyle, yani herhangi bir döndürme uygulanmadan nesne algılamasını gerçekleştirir. Bu yöntemi yalnızca ObjectDetector, ERROR(/RunningMode.IMAGE) ile oluşturulduğunda kullanın.

ObjectDetector, 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 ObjectDetectorResult detect (MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions)

Sağlanan tekli resimde nesne algılamayı gerçekleştirir. Bu yöntemi yalnızca ObjectDetector, ERROR(/RunningMode.IMAGE) ile oluşturulduğunda kullanın.

ObjectDetector, 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)

Nesne algılama işlemi gerçekleştirmek için canlı görüntü verilerini gönderir. Sonuçlar, ObjectDetector.ObjectDetectorOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla kullanılabilir. Bu yöntemi yalnızca ObjectDetector, ERROR(/RunningMode.LIVE_STREAM) ile oluşturulduğunda kullanın.

Giriş görüntüsünün nesne 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.

ObjectDetector, 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) nesne algılamak için canlı resim verilerini gönderir ve sonuçlar, ObjectDetector.ObjectDetectorOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla sunulur. Bu yöntemi yalnızca ObjectDetector, ERROR(/RunningMode.LIVE_STREAM) ile oluşturulduğunda kullanın.

Giriş görüntüsünün nesne 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.

ObjectDetector, 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 ObjectDetectorResult detectForVideo (MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun timestampM'ler)

Sağlanan video karesinde nesne algılamayı gerçekleştirir. Bu yöntemi yalnızca ObjectDetector, 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.

ObjectDetector, 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 ObjectDetectorResult detectForVideo (MPImage resmi, uzun zaman damgaları)

Sağlanan video karesinde, varsayılan resim işleme seçenekleriyle (yani herhangi bir döndürme uygulanmadan) nesne algılamayı gerçekleştirir. Bu yöntemi yalnızca ObjectDetector, 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.

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