Framework MediaPipe sur Android

Veuillez suivre les instructions ci-dessous pour créer des exemples d'applications Android avec le framework MediaPipe. Pour en savoir plus sur ces exemples d'applications, commencez par Hello World sur Android.

Créer des applications exemple Android avec Bazel

Conditions préalables

  • Installez le framework MediaPipe en suivant ces instructions.
  • Configurez l'environnement d'exécution Java.
  • Configurez la version 30.0.0 ou ultérieure du SDK Android.
  • Configurez la version 26 ou ultérieure du NDK Android.

MediaPipe recommande de configurer le SDK et le NDK Android via Android Studio (voir ci-dessous pour la configuration d'Android Studio). Toutefois, si vous préférez utiliser MediaPipe sans Android Studio, veuillez exécuter setup_android_sdk_and_ndk.sh pour télécharger et configurer le SDK et le NDK Android avant de créer des applications exemple Android.

Si le SDK et le NDK Android sont déjà installés (par exemple, par Android Studio), définissez $ANDROID_HOME et $ANDROID_NDK_HOME pour qu'ils pointent vers le SDK et le NDK installés.

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

Ajoutez les règles android_ndk_repository(), android_sdk_repository() et bind() au fichier WORKSPACE comme suit:

$ 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

Pour utiliser le framework sur les versions antérieures d'Android, MediaPipe doit passer à un niveau d'API Android inférieur. Pour ce faire, spécifiez api_level = $YOUR_INTENDED_API_LEVEL dans android_ndk_repository() et/ou android_sdk_repository() dans le fichier WORKSPACE.

  1. Pour créer une application exemple Android, compilez-la avec la cible de compilation android_binary correspondante. Par exemple, pour MediaPipe Hands, la cible est handtrackinggpu dans le fichier BUILD:

    bazel build -c opt --config=android_arm64 mediapipe/examples/android/src/java/com/google/mediapipe/apps/handtrackinggpu:handtrackinggpu
    
  2. Installez-le sur un appareil avec:

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