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

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

الأجهزة والأنظمة الأساسية المتوافقة

لإنشاء تطبيقات Android باستخدام MediaPipe Tasks، فإن ما يلي:

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

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

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

إعداد جهاز Android

يجب تفعيل خيار "خيارات المطوّرين" و"تصحيح أخطاء الجهاز عبر USB" على جهاز 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 Studio في مشاريع أخرى أم لا. عند إنشاء مكتمل، سيعرض "استوديو Android" رسالة BUILD SUCCESSFUL في لوحة حالة إنشاء نتيجة.

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

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

تبعيات "مهام MediaPipe"

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

المهام المتعلّقة بالذكاء الاصطناعي التوليدي

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

منشئ الصور

يتم تضمين مهمة منشئ صور MediaPipe ضمن مكتبة 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 "مهام Google" في "استوديو Android"، أضِف الاعتماديات التالية إلى ملف build.gradle:

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

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

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

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

مهام صوتية

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

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

إعدادات BaseOptions

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

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

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

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

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

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

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

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