إطار عمل MediaPipe على نظام التشغيل Android

يُرجى اتّباع التعليمات أدناه لإنشاء أمثلة على تطبيقات Android باستخدام إطار عمل MediaPipe. للاطّلاع على مزيد من المعلومات عن أمثلة التطبيقات هذه، ابدأ من مقالة Hello World! على Android.

إنشاء أمثلة على تطبيقات Android باستخدام Bazel

المتطلبات الأساسية

  • ثبِّت إطار عمل MediaPipe باتّباع هذه التعليمات.
  • إعداد بيئة تشغيل Java
  • عليك إعداد الإصدار 30.0.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
  • عليك تثبيت الإصدار 26 أو إصدار أحدث من حزمة Android NDK.

تنصح MediaPipe بإعداد حزمة تطوير البرامج (SDK) لنظام التشغيل Android ومجموعة تطوير البرامج (NDK) من خلال "استوديو Android" (اطّلِع على الخطوات التالية لإعداد "استوديو Android"). ومع ذلك، إذا كنت تفضّل استخدام MediaPipe بدون "استوديو Android"، يُرجى تشغيل setup_android_sdk_and_ndk.sh لتنزيل حزمة تطوير البرامج (SDK) لنظام التشغيل Android ومجموعة تطوير البرامج (NDK) وإعدادهما قبل إنشاء أي مثال على تطبيقات Android.

إذا سبق أن تم تثبيت حزمة SDK وNDK لنظام التشغيل Android (مثلاً، باستخدام "استوديو Android")، اضبط $ANDROID_HOME و$ANDROID_NDK_HOME للإشارة إلى حزمة SDK وNDK المثبّتَين.

export ANDROID_HOME=<path to the Android SDK>
export ANDROID_NDK_HOME=<path to the Android NDK>

وأضِف قواعد android_ndk_repository() وandroid_sdk_repository() وbind() إلى ملف WORKSPACE على النحو التالي:

$ echo "android_sdk_repository(name = \"androidsdk\")" >> WORKSPACE
$ echo "android_ndk_repository(name = \"androidndk\", api_level=26)" >> WORKSPACE
$ echo "bind(name = \"android/crosstool\", actual = \"@androidndk//:toolchain\")" >> WORKSPACE

لاستخدام Framework على إصدارات Android الأقدم، يجب أن تبدِّل MediaPipe إلى مستوى أقل من واجهة برمجة تطبيقات Android. يمكنك تحقيق ذلك من خلال تحديد api_level = $YOUR_INTENDED_API_LEVEL في دالة android_ndk_repository() و/أو دالة android_sdk_repository() في ملف WORKSPACE.

  1. لإنشاء مثال لتطبيق Android، يمكنك إجراء عملية الإنشاء باستخدام ملف تعريف الإصدار المعني android_binary. على سبيل المثال، بالنسبة إلى MediaPipe Hands، يكون القيمة المستهدفة handtrackinggpu فيملف BUILD:

    bazel build -c opt --config=android_arm64 mediapipe/examples/android/src/java/com/google/mediapipe/apps/handtrackinggpu:handtrackinggpu
    
  2. تثبيته على جهاز مزوّد بما يلي:

    adb install bazel-bin/mediapipe/examples/android/src/java/com/google/mediapipe/apps/handtrackinggpu/handtrackinggpu.apk