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
vecoordinate_type=RATIO
belirtilmelidir.
- [top, left, right, bottom] biçimindeki sınırlayıcı kutuları temsil eden iç dizi olan
- 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.
- Her değer, bir sınıfın tam sayı dizinini temsil eden
- 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.
- Konum tensörü (
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 | |
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 | |
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. |