ينفذ الكشف عن الكائنات على الصور.
تتوقع واجهة برمجة التطبيقات (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. |
الأساليب العامة
الطرق الموروثة
الأساليب العامة
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 الخيارات)
إنشاء مثيل ObjectDetector
من ObjectDetector.ObjectDetectorOptions
.
حدود
سياق | |
---|---|
modelPath | المسار إلى نموذج الكشف مع البيانات الوصفية في الأصول |
خيارات |
رميات
IOEException | في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite |
---|---|
غير الشرعيين استثناء حجة | إذا كانت الوسيطة غير صالحة |
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
ObjectDetector الثابت العام createFromFileAndOptions ( ملف modelFile، خيارات ObjectDetector.ObjectDetectorOptions )
إنشاء مثيل ObjectDetector
من ObjectDetector.ObjectDetectorOptions
.
حدود
modelFile | مثيل File نموذج الكشف |
---|---|
خيارات |
رميات
IOEException | في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite |
---|---|
غير الشرعيين استثناء حجة | إذا كانت الوسيطة غير صالحة |
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
القائمة العامة < الكشف > الكشف (صورة MlImage )
ينفذ الكشف الفعلي على MlImage
.
حدود
صورة | كائن MlImage الذي يمثل صورة |
---|
رميات
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
---|---|
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
غير الشرعيين استثناء حجة | إذا كان نوع تخزين الصورة أو تنسيقها غير مدعوم |
كشف القائمة العامة < الكشف > (صورة TensorImage ، خيارات ImageProcessingOptions )
ينفذ الكشف الفعلي على الصورة المقدمة.
يدعم ObjectDetector
أنواع مساحات الألوان TensorImage
التالية:
يدعم ObjectDetector
الخيارات التالية:
- تدوير الصورة (من خلال
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). الافتراضي هوImageProcessingOptions.Orientation.TOP_LEFT
.
حدود
صورة | كائن UINT8 TensorImage الذي يمثل صورة RGB أو YUV |
---|---|
خيارات | خيارات تكوين كيفية المعالجة المسبقة للصورة |
رميات
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
---|---|
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
غير الشرعيين استثناء حجة | إذا كان نوع مساحة اللون للصورة غير مدعوم |
كشف القائمة العامة < الكشف > (صورة MlImage ، خيارات ImageProcessingOptions )
يقوم بالكشف الفعلي على MlImage
المزود باستخدام ImageProcessingOptions
.
يدعم ObjectDetector
الخيارات التالية:
- تدوير الصورة (من خلال
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). الافتراضي هوImageProcessingOptions.Orientation.TOP_LEFT
.MlImage.getRotation()
غير فعال.
حدود
صورة | كائن MlImage الذي يمثل صورة |
---|---|
خيارات | خيارات تكوين كيفية المعالجة المسبقة للصورة |
رميات
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
---|---|
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
غير الشرعيين استثناء حجة | إذا كان نوع تخزين الصورة أو تنسيقها غير مدعوم |
القائمة العامة < الكشف > الكشف (صورة TensorImage )
ينفذ الكشف الفعلي على الصورة المقدمة.
يدعم ObjectDetector
أنواع مساحات الألوان TensorImage
التالية:
حدود
صورة | كائن UINT8 TensorImage الذي يمثل صورة RGB أو YUV |
---|
رميات
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
---|---|
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
غير الشرعيين استثناء حجة | إذا كان نوع مساحة اللون للصورة غير مدعوم |