ObjectDetector

ObjectDetector من الفئة النهائية العامة

ينفذ الكشف عن الكائنات على الصور.

تتوقع واجهة برمجة التطبيقات (API) نموذج TFLite مع بيانات تعريف نموذج TFLite. .

تدعم واجهة برمجة التطبيقات النماذج التي تحتوي على موتر إدخال صورة واحد وأربعة موترات إخراج. لنكون أكثر تحديدا، وهنا المتطلبات.

  • موتر صورة الإدخال ( kTfLiteUInt8 / kTfLiteFloat32 )
    • حجم إدخال الصورة [batch x height x width x channels] .
    • استنتاج الدُفعة غير مدعوم (يُشترط أن تكون batch 1).
    • يتم دعم مدخلات RGB فقط (يجب أن تكون channels 3).
    • إذا كان النوع هو kTfLiteFloat32 ، فيجب إرفاق خيارات التسوية بالبيانات الوصفية لتطبيع الإدخال.
  • يجب أن تكون موترات الإخراج هي المخرجات الأربعة لعملية DetectionPostProcess ، على سبيل المثال:
    • موتر الموقع ( kTfLiteFloat32 ):
      • موتر الحجم [1 x num_results x 4] ، المصفوفة الداخلية التي تمثل المربعات المحيطة في النموذج [أعلى، يسار، يمين، أسفل].
      • يلزم إرفاق BoundingBoxProperties بالبيانات التعريفية ويجب تحديد type=BOUNDARIES و coordinate_type=RATIO .
    • موتر الطبقات ( kTfLiteFloat32 ):
      • موتر الحجم [1 x num_results] ، كل قيمة تمثل الفهرس الصحيح للفئة.
      • إذا تم إرفاق خرائط الملصقات بالبيانات التعريفية كملفات مرتبطة بـ TENSOR_VALUE_LABELS ، فسيتم استخدامها لتحويل قيم الموتر إلى تسميات.
    • عشرات الموتر ( kTfLiteFloat32 ):
      • موتر الحجم [1 x num_results] ، تمثل كل قيمة نتيجة الكائن المكتشف.
    • عدد موتر الكشف ( kTfLiteFloat32 ):
      • عدد صحيح num_results كموتر بالحجم [1] .

يمكن العثور على مثال لهذا النموذج على TensorFlow Hub. .

فئات متداخلة

فصل ObjectDetector.ObjectDetectorOptions خيارات لإعداد ObjectDetector.

الأساليب العامة

كاشف الكائنات الثابت
createFromBuffer (نموذج ByteBuffer )
ينشئ مثيل ObjectDetector مع مخزن مؤقت للنموذج و ObjectDetector.ObjectDetectorOptions الافتراضي.
كاشف الكائنات الثابت
createFromBufferAndOptions (خيارات ByteBuffer modelBuffer، ObjectDetector.ObjectDetectorOptions )
ينشئ مثيل ObjectDetector مع مخزن مؤقت للنموذج و ObjectDetector.ObjectDetectorOptions .
كاشف الكائنات الثابت
createFromFile (سياق السياق، String modelPath)
إنشاء مثيل ObjectDetector من ObjectDetector.ObjectDetectorOptions الافتراضي.
كاشف الكائنات الثابت
createFromFile ( ملف نموذج الملف)
إنشاء مثيل ObjectDetector من ObjectDetector.ObjectDetectorOptions الافتراضي.
كاشف الكائنات الثابت
createFromFileAndOptions (سياق السياق، خيارات String modelPath، ObjectDetector.ObjectDetectorOptions )
كاشف الكائنات الثابت
قائمة < الكشف >
كشف (صورة MlImage )
ينفذ الكشف الفعلي على MlImage .
قائمة < الكشف >
كشف (صورة TensorImage ، خيارات ImageProcessingOptions )
ينفذ الكشف الفعلي على الصورة المقدمة.
قائمة < الكشف >
كشف (صورة MlImage ، خيارات ImageProcessingOptions )
يقوم بالكشف الفعلي على MlImage المزود باستخدام ImageProcessingOptions .
قائمة < الكشف >
كشف (صورة TensorImage )
ينفذ الكشف الفعلي على الصورة المقدمة.

الطرق الموروثة

الأساليب العامة

ObjectDetector الثابت العام createFromBuffer ( ByteBuffer modelBuffer)

ينشئ مثيل ObjectDetector مع مخزن مؤقت للنموذج و ObjectDetector.ObjectDetectorOptions الافتراضي.

حدود
modelBuffer ByteBuffer مباشر أو MappedByteBuffer لنموذج الكشف
رميات
غير الشرعيين استثناء حجة إذا كان المخزن المؤقت للنموذج ليس ByteBuffer مباشرًا أو MappedByteBuffer *throws IllegalStateException إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد

ObjectDetector الثابت العام createFromBufferAndOptions (خيارات ByteBuffer modelBuffer، ObjectDetector.ObjectDetectorOptions )

ينشئ مثيل ObjectDetector مع مخزن مؤقت للنموذج و ObjectDetector.ObjectDetectorOptions .

حدود
modelBuffer ByteBuffer مباشر أو MappedByteBuffer لنموذج الكشف
خيارات
رميات
غير الشرعيين استثناء حجة إذا كان المخزن المؤقت للنموذج ليس ByteBuffer مباشرًا أو MappedByteBuffer
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد

ObjectDetector الثابت العام createFromFile (سياق السياق، String modelPath)

إنشاء مثيل ObjectDetector من ObjectDetector.ObjectDetectorOptions الافتراضي.

حدود
سياق
modelPath المسار إلى نموذج الكشف مع البيانات الوصفية في الأصول
رميات
IOEException في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite
غير الشرعيين استثناء حجة إذا كانت الوسيطة غير صالحة
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد

ObjectDetector العام الثابت createFromFile ( ملف modelFile)

إنشاء مثيل ObjectDetector من ObjectDetector.ObjectDetectorOptions الافتراضي.

حدود
modelFile مثيل File نموذج الكشف
رميات
IOEException في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite
غير الشرعيين استثناء حجة إذا كانت الوسيطة غير صالحة
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد

ObjectDetector العام الثابت createFromFileAndOptions (سياق السياق، String modelPath، ObjectDetector.ObjectDetectorOptions الخيارات)

حدود
سياق
modelPath المسار إلى نموذج الكشف مع البيانات الوصفية في الأصول
خيارات
رميات
IOEException في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite
غير الشرعيين استثناء حجة إذا كانت الوسيطة غير صالحة
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد

ObjectDetector الثابت العام createFromFileAndOptions ( ملف modelFile، خيارات ObjectDetector.ObjectDetectorOptions )

حدود
modelFile مثيل File نموذج الكشف
خيارات
رميات
IOEException في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite
غير الشرعيين استثناء حجة إذا كانت الوسيطة غير صالحة
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد

القائمة العامة < الكشف > الكشف (صورة MlImage )

ينفذ الكشف الفعلي على MlImage .

حدود
صورة كائن MlImage الذي يمثل صورة
رميات
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد
غير الشرعيين استثناء حجة إذا كان نوع تخزين الصورة أو تنسيقها غير مدعوم

كشف القائمة العامة < الكشف > (صورة TensorImage ، خيارات ImageProcessingOptions )

ينفذ الكشف الفعلي على الصورة المقدمة.

يدعم ObjectDetector أنواع مساحات الألوان TensorImage التالية:

يدعم ObjectDetector الخيارات التالية:

حدود
صورة كائن UINT8 TensorImage الذي يمثل صورة RGB أو YUV
خيارات خيارات تكوين كيفية المعالجة المسبقة للصورة
رميات
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد
غير الشرعيين استثناء حجة إذا كان نوع مساحة اللون للصورة غير مدعوم

كشف القائمة العامة < الكشف > (صورة MlImage ، خيارات ImageProcessingOptions )

يقوم بالكشف الفعلي على MlImage المزود باستخدام ImageProcessingOptions .

يدعم ObjectDetector الخيارات التالية:

حدود
صورة كائن MlImage الذي يمثل صورة
خيارات خيارات تكوين كيفية المعالجة المسبقة للصورة
رميات
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد
غير الشرعيين استثناء حجة إذا كان نوع تخزين الصورة أو تنسيقها غير مدعوم

القائمة العامة < الكشف > الكشف (صورة TensorImage )

ينفذ الكشف الفعلي على الصورة المقدمة.

يدعم ObjectDetector أنواع مساحات الألوان TensorImage التالية:

حدود
صورة كائن UINT8 TensorImage الذي يمثل صورة RGB أو YUV
رميات
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد
غير الشرعيين استثناء حجة إذا كان نوع مساحة اللون للصورة غير مدعوم