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

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

إنشاء نماذج تطبيقات Android باستخدام Bazel

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

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

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

إذا سبق تثبيت حزمة تطوير البرامج (SDK) لنظام التشغيل Android وNDK (من خلال "استوديو 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() إلى ملف WORKSPACE على النحو التالي:

$ echo "android_sdk_repository(name = \"androidsdk\")" >> WORKSPACE
$ echo "android_ndk_repository(name = \"androidndk\", api_level=21)" >> WORKSPACE

لاستخدام إطار العمل على إصدارات 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