تعرَّف على مزيد من المعلومات حول إشعارات Google AI Edge من مؤتمر I/O.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

ImageEmbedder

الصف النهائي المتاح للجميع ImageEmbedder

تتيح هذه الميزة استخراج الصور.

نتوقّع في واجهة برمجة التطبيقات استخدام نموذج TFLite مع البيانات الوصفية لنموذج TFLite الاختيارية ولكن ننصح بها بشدة.

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

إدخال موسِّع صورة (kTfLiteUInt8/kTfLiteFloat32)
- إدخال صورة بحجم [batch x height x width x channels]
- الاستنتاج المجمَّع غير متاح (يجب أن تكون القيمة batch 1).
- لا يمكن استخدام سوى إدخالات نموذج أحمر أخضر أزرق (يجب أن تكون القيمة channels 3).
- إذا كان النوع kTfLiteFloat32، يجب إرفاق خيارات التسوية بالبيانات الوصفية بهدف تسوية الإدخال.
متوتر إخراج واحد على الأقل (kTfLiteUInt8/kTfLiteFloat32) بالشكل [1 x N] حيث N هو عدد الأبعاد في التضمينات الناتجة.

الصفوف المتداخلة

صنف ImageEmbedder.ImageEmbedderOptions خيارات الإعداد وImageEmbedder.

الطرق العامة

ثابت مزدوج	cosineSimilarity(تضمين u, تضمين v) دالة أداة لاحتساب تماثل جيب التمام بين كائنَي `Embedding`.
ثابت ImageEmbedder	createFromBuffer(سياق السياق، ByteBuffer modelBuffer) تنشئ هذه الدالة `ImageEmbedder` مثيلاً من مخزن نموذجي ويُستخدَم التلقائي `ImageEmbedder.ImageEmbedderOptions`.
ثابت ImageEmbedder	createFromFile(سياق السياق، مسار نموذج سلسلة) تنشئ هذه الدالة مثيل `ImageEmbedder` من ملف نموذج وتنشئ `ImageEmbedder.ImageEmbedderOptions` تلقائيًا.
ثابت ImageEmbedder	createFromFile(سياق السياق، File modelFile) تنشئ هذه الدالة مثيل `ImageEmbedder` من ملف نموذج وتنشئ `ImageEmbedder.ImageEmbedderOptions` تلقائيًا.
ثابت ImageEmbedder	createFromOptions(سياق السياق، خيارات ImageEmbedder.ImageEmbedderOptions) تنشئ هذه الدالة `ImageEmbedder` من مثيل `ImageEmbedder.ImageEmbedderOptions`.
ImageEmbedderResult	embed(MPImage image, ImageProcessingOptions imageProcessingOptions) ينفّذ هذا الإجراء استخراج البيانات على الصورة المفردة المقدّمة.
ImageEmbedderResult	embed(MPImage image) يتم تنفيذ استخراج التضمين على الصورة الواحدة المقدّمة باستخدام خيارات معالجة الصور التلقائية، أي
void	embedAsync(صورة MPImage، وImageProcessingOptions خيارات معالجة الصورة، وطابع زمني طويل) يرسل بيانات صور مباشرة لإجراء استخراج البيانات ضمنها، وستكون النتائج متاحة من خلال `OutputHandler.ResultListener` المقدّمة في `ImageEmbedder.ImageEmbedderOptions`.
void	embedAsync(صورة MPImage، والطابع الزمني الطويل) يرسل بيانات صور مباشرة لإجراء استخراج التضمين باستخدام خيارات معالجة الصور التلقائية، أي
ImageEmbedderResult	embedForVideo(صورة MPImage، ImageProcessingOptions imageProcessingOptions، الطوابع الزمنية الطويلة) ينفّذ هذا الإجراء استخراج البيانات في إطار الفيديو المتوفّر.
ImageEmbedderResult	embedForVideo(صورة MPImage، الطوابع الزمنية الطويلة) يتم استخراج تضمين في إطار الفيديو المتوفر مع خيارات معالجة الصور التلقائية، أي

الطرق المكتسَبة

من الصف com.google.mediapipe.tasks.vision.core.BaseVisionTaskApi

void	Close() إغلاق مهمة رؤية MediaPipe وتنقيحها.
ثابت طويل	generateResultTimestampMs(RunningMode runningMode, Packet package) ينشئ الطابع الزمني لكائن نتيجة مهمة الرؤية من وضع تشغيل مهمة الرؤية وحزمة الإخراج.

من الفئة java.lang.Object

boolean	يساوي(كائن arg0)
last الفئة<?>	getClass()
int	hashCode()
النتيجة النهائية باطلة	notify()
النتيجة النهائية باطلة	notifyAll()
String	toString()
النتيجة النهائية باطلة	انتظار(صيغة طويلة arg0, int arg1)
النتيجة النهائية باطلة	انتظار(صيغة طويلة arg0)
النتيجة النهائية باطلة	انتظار()

من الواجهة java.lang.AutoCloseable

تجريدي باطل

CLOSE()

الطرق العامة

public static مزدوج cosineSimilarity (تضمين u، التضمين إصدار)

دالة أداة لاحتساب تماثل جيب التمام بين كائنَي Embedding.

المَعلمات

u
v

الرميات

IllegalArgumentException	إذا كانت التضمينات من أنواع مختلفة (عدد عائم مقابل الكمية) أو لها أحجام مختلفة أو لها معيار L2 تساوي 0.

public static ImageEmbedder createFromBuffer (سياق السياق، ByteBuffer formBuffer)

تنشئ هذه الدالة ImageEmbedder مثيلاً من مخزن نموذجي ويُستخدَم التلقائي ImageEmbedder.ImageEmbedderOptions.

المَعلمات

سياق	جهاز Android `ERROR(/Context)`
modelBuffer	`ByteBuffer` أو `ERROR(/MappedByteBuffer)` لنموذج التضمين.

الرميات

	في حال حدوث خطأ أثناء إنشاء "`ImageEmbedder`".

public static ImageEmbedder createFromFile (سياق السياق، سلسلة formPath)

تنشئ هذه الدالة مثيل ImageEmbedder من ملف نموذج وتنشئ ImageEmbedder.ImageEmbedderOptions تلقائيًا.

المَعلمات

سياق	جهاز Android `ERROR(/Context)`
modelPath	المسار إلى نموذج التضمين في مواد العرض.

الرميات

	في حال حدوث خطأ أثناء إنشاء "`ImageEmbedder`".

public static ImageEmbedder createFromFile (سياق السياق، ملف formFile)

تنشئ هذه الدالة مثيل ImageEmbedder من ملف نموذج وتنشئ ImageEmbedder.ImageEmbedderOptions تلقائيًا.

المَعلمات

سياق	جهاز Android `ERROR(/Context)`
modelFile	مثيل نموذج التضمين `File`.

الرميات

IOException	في حال حدوث خطأ في وحدات الإدخال والإخراج عند فتح ملف نموذج tflite.
	في حال حدوث خطأ أثناء إنشاء "`ImageEmbedder`".

public static ImageEmbedder createFromOptions (سياق السياق، ImageEmbedder.ImageEmbedderOptions)

تنشئ هذه الدالة ImageEmbedder من مثيل ImageEmbedder.ImageEmbedderOptions.

المَعلمات

سياق	جهاز Android `ERROR(/Context)`
الخيارات	مثيل `ImageEmbedder.ImageEmbedderOptions`.

الرميات

	في حال حدوث خطأ أثناء إنشاء "`ImageEmbedder`".

Public ImageEmbedderResult embed (MPImage image, ImageProcessingOptions imageProcessingOptions)

ينفّذ هذا الإجراء استخراج البيانات على الصورة المفردة المقدّمة. لا تستخدِم هذه الطريقة إلا عند إنشاء ImageEmbedder باستخدام ERROR(/RunningMode.IMAGE).

يتيح ImageEmbedder استخدام أنواع مساحات الألوان التالية:

ERROR(/Bitmap.Config.ARGB_8888)

المَعلمات

صورة	كائن MediaPipe `MPImage` للمعالجة.
imageProcessingOptions	`ImageProcessingOptions` التي تحدِّد كيفية معالجة الصورة التي تم إدخالها قبل تنفيذ الاستنتاج

الرميات

	في حال حدوث خطأ داخلي.

public ImageEmbedderResult embed (MPImage image)

تُجري استخراج التضمين على الصورة الواحدة المقدّمة باستخدام خيارات معالجة الصور التلقائية، أي استخدام الصورة بأكملها كمنطقة اهتمام بدون تطبيق أي تدوير. لا تستخدِم هذه الطريقة إلا عند إنشاء ImageEmbedder من خلال ERROR(/RunningMode.IMAGE).

يتيح ImageEmbedder استخدام أنواع مساحات الألوان التالية:

ERROR(/Bitmap.Config.ARGB_8888)

المَعلمات

صورة	كائن MediaPipe `MPImage` للمعالجة.

الرميات

	في حال حدوث خطأ داخلي.

متاح للجميع إبطال embedAsync (MPImage صورة، ImageProcessingOptions imageProcessingOptions، الطوابع الزمنية الطويلة)

يرسل بيانات صور مباشرة لإجراء استخراج البيانات ضمنها، وستكون النتائج متاحة من خلال OutputHandler.ResultListener المقدّمة في ImageEmbedder.ImageEmbedderOptions. لا تستخدِم هذه الطريقة إلا عند إنشاء ImageEmbedder باستخدام ERROR(/RunningMode.LIVE_STREAM).

يجب توفير طابع زمني (بالمللي ثانية) للإشارة إلى وقت إرسال صورة الإدخال إلى أداة رصد العناصر. يجب أن تكون الطوابع الزمنية للإدخال تزيد بشكل منتظم.

يتيح ImageEmbedder استخدام أنواع مساحات الألوان التالية:

ERROR(/Bitmap.Config.ARGB_8888)

المَعلمات

صورة	كائن MediaPipe `MPImage` للمعالجة.
imageProcessingOptions	`ImageProcessingOptions` التي تحدِّد كيفية معالجة الصورة التي تم إدخالها قبل تنفيذ الاستنتاج
timestampMs	الطابع الزمني للإدخال (بالمللي ثانية).

الرميات

	في حال حدوث خطأ داخلي.

public إبطال embedAsync (صورة MPImage، الطوابع الزمنية الطويلة)

يرسل بيانات الصور المباشرة لإجراء استخراج التضمين باستخدام خيارات معالجة الصور التلقائية، أي استخدام الصورة بأكملها كمنطقة اهتمام وبدون تطبيق أي تغيير عليها، وستكون النتائج متاحة من خلال OutputHandler.ResultListener المتوفرة في ImageEmbedder.ImageEmbedderOptions. لا تستخدِم هذه الطريقة إلا عند إنشاء ImageEmbedder باستخدام ERROR(/RunningMode.LIVE_STREAM).

يتيح ImageEmbedder استخدام أنواع مساحات الألوان التالية:

ERROR(/Bitmap.Config.ARGB_8888)

المَعلمات

صورة	كائن MediaPipe `MPImage` للمعالجة.
timestampMs	الطابع الزمني للإدخال (بالمللي ثانية).

الرميات

	في حال حدوث خطأ داخلي.

public ImageEmbedderResult embedForVideo (MPImage صورة، ImageProcessingOptions imageProcessingOptions, timestampMs)

ينفّذ هذا الإجراء استخراج البيانات في إطار الفيديو المتوفّر. لا تستخدِم هذه الطريقة إلا عند إنشاء ImageEmbedder من خلال ERROR(/RunningMode.VIDEO).

يجب تقديم الطابع الزمني لإطار الفيديو (بالمللي ثانية). يجب أن تكون الطوابع الزمنية للإدخالات متزايدة بشكل منتظم.

يتيح ImageEmbedder استخدام أنواع مساحات الألوان التالية:

ERROR(/Bitmap.Config.ARGB_8888)

المَعلمات

صورة	كائن MediaPipe `MPImage` للمعالجة.
imageProcessingOptions	`ImageProcessingOptions` التي تحدِّد كيفية معالجة الصورة التي تم إدخالها قبل تنفيذ الاستنتاج
timestampMs	الطابع الزمني للإدخال (بالمللي ثانية).

الرميات

	في حال حدوث خطأ داخلي.

public ImageEmbedderResult embedForVideo (MPImage صورة، الطوابع الزمنية الطويلة)

تعمل هذه الميزة على تنفيذ استخراج التضمين في إطار الفيديو المقدَّم من خلال خيارات معالجة الصور التلقائية، أي استخدام الصورة بأكملها كمنطقة اهتمام بدون تطبيق أي تدوير. لا تستخدِم هذه الطريقة إلا عند إنشاء ImageEmbedder من خلال ERROR(/RunningMode.VIDEO).

يتيح ImageEmbedder استخدام أنواع مساحات الألوان التالية:

ERROR(/Bitmap.Config.ARGB_8888)

المَعلمات

صورة	كائن MediaPipe `MPImage` للمعالجة.
timestampMs	الطابع الزمني للإدخال (بالمللي ثانية).

الرميات

	في حال حدوث خطأ داخلي.