دليل الإعداد لنظام التشغيل Android

توضّح لك هذه الصفحة كيفية إعداد بيئة التطوير لاستخدام مهام MediaPipe في تطبيقات Android.

الأجهزة والمنصّات المتوافقة

لإنشاء تطبيقات Android باستخدام مهام MediaPipe، تتطلب بيئة التطوير ما يلي:

• استوديو Android باستخدام إصدار مقترَح من الإصدار 2021.1.1 (Bumblebee) على الأقل أو بيئة تطوير متكاملة أخرى متوافقة.
• الإصدار 24 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android أو إصدار أحدث
• جهاز Android يتضمّن الإصدار الأدنى من حزمة تطوير البرامج (SDK) على الأقل قد لا يعمل محاكي Android مع كل المهام.

إعداد بيئة المطوّر

قبل تشغيل مَهمّة MediaPipe على أحد تطبيقات Android، يجب أن يكون لديك تطبيق حالي أو إنشاء مشروع جديد في "استوديو Android" على جهازك المحلي. يتناسب MediaPipe مع طبقة البيانات في تطبيقك، والتي تحتوي على بيانات التطبيق ومنطق النشاط التجاري. للحصول على مزيد من المعلومات حول بنية تطبيقات Android، يمكنك الرجوع إلى دليل بنية التطبيق.

إعداد جهاز Android

يجب تفعيل "خيارات المطوّرين" و"تصحيح أخطاء الجهاز عبر USB" على جهاز Android فعلي قبل استخدامه لاختبار تطبيقك. للحصول على تعليمات حول كيفية ضبط جهازك باستخدام "خيارات المطوّرين"، يمكنك مراجعة ضبط خيارات المطوّرين على الجهاز فقط.

بالنسبة إلى المهام التي لا تتطلب كاميرا أو ميكروفون جهاز، يمكنك استخدام محاكي جهاز Android بدلاً من جهاز Android فعلي. وللحصول على تعليمات حول إعداد محاكي Android، يُرجى الاطّلاع على مقالة تشغيل التطبيقات على محاكي Android.

مثال على إعداد الرمز

يحتوي مستودع MediaPipe أمثلة على أمثلة على تطبيقات Android لكل مهمة من مهام MediaPipe. يمكنك إنشاء مشروع من نموذج التعليمات البرمجية وإنشاء المشروع ثم تشغيله.

لاستيراد نموذج مشروع الرمز البرمجي وإنشاءه:

1. افتح استوديو Android.
2. من "استوديو Android"، اختَر ملف > جديد > استيراد مشروع.
3. انتقِل إلى نموذج دليل الرموز الذي يحتوي على ملف build.gradle واختَر هذا الدليل، على سبيل المثال: .../mediapipe/examples/text_classification/android/build.gradle
4. إذا كان "استوديو Android" يطلب إجراء مزامنة Gradle، اختَر حسنًا.
5. تأكد من أن جهاز Android متصل بجهاز الكمبيوتر وأن وضع مطوّر البرامج مُفعَّل. انقر على السهم الأخضر Run.

إذا اخترت الدليل الصحيح، سينشئ "استوديو Android" مشروعًا جديدًا وينشئه. يمكن أن تستغرق هذه العملية بضع دقائق، حسب سرعة الكمبيوتر وما إذا كنت تستخدم "استوديو Android" في مشاريع أخرى. عند اكتمال الإصدار، يعرض "استوديو Android" رسالة BUILD SUCCESSFUL في لوحة الحالة إنشاء المخرجات.

لتشغيل المشروع:

1. من "استوديو Android"، شغِّل المشروع من خلال اختيار تشغيل > تشغيل....
2. اختَر جهاز Android (أو محاكيًا) مرفقًا لاختبار التطبيق.

تبعيات مهام MediaPipe

توفر مهام MediaPipe ثلاث مكتبات مُعدة مسبقًا للرؤية والنص والصوت. يجب وضع ملف نموذج .tflite في دليل مواد العرض بوحدة Android التي تستخدم النموذج. بناءً على مهمة MediaPipe التي يستخدمها التطبيق، أضِف مكتبة الرؤية أو النص أو الملفات الصوتية إلى قائمة التبعيات ضمن ملف build.gradle.

مهام الذكاء الاصطناعي التوليدي

تحتوي مكتبات MediaPipe للذكاء الاصطناعي التوليدي على مهام تعالج إنشاء الصور أو النصوص. لاستيراد مكتبات الذكاء الاصطناعي التوليدي في "مهام MediaPipe" إلى "استوديو Android"، أضِف التبعيات إلى ملف build.gradle.

منشئ الصور

تتوفّر مهمة MediaPipe Image Generator في مكتبة tasks-vision-image-generator. أضِف التبعية إلى ملف build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-vision-image-generator:latest.release'
}

واجهة برمجة التطبيقات للاستنتاج اللغوي الكبير

تتوفّر مهمة استنتاج MediaPipe LLM في مكتبة tasks-genai. أضِف التبعية إلى ملف build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-genai:latest.release'
}

مهام بصرية

تحتوي مكتبة رؤية "مهام MediaPipe" على مهام تعالج إدخالات الصور أو الفيديو. لاستيراد مكتبة رؤية "مهام MediaPipe" في "استوديو Android"، أضِف التبعيات التالية إلى ملف build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-vision:latest.release'
}

المهام النصية

تحتوي مكتبة نص "مهام MediaPipe" على مهام تعالج بيانات اللغة بتنسيق نصي. لاستيراد مكتبة نصوص "مهام MediaPipe" في "استوديو Android"، أضِف التبعيات التالية إلى ملف build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-text:latest.release'
}

المهام الصوتية

تحتوي مكتبة الملفات الصوتية في "مهام MediaPipe" على مهام تعالج إدخالات الصوت. لاستيراد مكتبة الملفات الصوتية في "مهام MediaPipe" إلى "استوديو Android"، أضِف التبعيات التالية إلى ملف build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-audio:latest.release'
}

إعدادات BaseOptions

يسمح BaseOptions بالإعداد العام لواجهات برمجة تطبيقات مهام MediaPipe.

اسم الخيار	الوصف	القيم المقبولة
modelAssetBuffer	محتوى ملف مادة عرض النموذج في شكل ByteBuffer أو MappedByteBuffer مباشر	ByteBuffer أو MappedByteBuffer كسلسلة
modelAssetPath	مسار النموذج لملف مادة عرض نموذج في مجلد مواد عرض تطبيقات Android.	مسار الملف كسلسلة
modelAssetFileDescriptor	العدد الصحيح لأداة وصف الملف الأصلي لملف مادة عرض للنموذج	عدد صحيح يحدد واصف الملف
Delegate	تعمل هذه السياسة على تفعيل تسريع الأجهزة من خلال تفويض جهاز لتشغيل مسار MediaPipe. القيمة التلقائية: CPU.	[CPU, GPU]

تسريع الأجهزة

تتيح "مهام MediaPipe" استخدام وحدات معالجة الرسومات (GPU) لتشغيل نماذج تعلُّم الآلة. على أجهزة Android، يمكنك تمكين استخدام تنفيذ وحدة معالجة الرسومات المسرّع لنماذجك باستخدام تفويض. تعمل المفوَّضات كبرامج تشغيل أجهزة لـ MediaPipe، ما يسمح لك بتشغيل نماذجك على معالِجات وحدة معالجة الرسومات بدلاً من معالِجات وحدة المعالجة المركزية القياسية.

ضبط تفويض وحدة معالجة الرسومات في خيارات المهام من خلال BaseOptions:

BaseOptions baseOptions = BaseOptions.builder().useGpu().build();

تحديد المشاكل وحلّها

للحصول على مساعدة بشأن الأسئلة التقنية المتعلقة بـ MediaPipe، يُرجى الانتقال إلى مجموعة المناقشة أو تجاوز تكديس للحصول على الدعم من المنتدى. للإبلاغ عن أخطاء أو تقديم طلبات ميزات، يمكنك الإبلاغ عن مشكلة على GitHub.

للحصول على المساعدة في إعداد بيئة تطوير Android، يمكنك الانتقال إلى مستندات مطوّري برامج Android.