Android の MediaPipe フレームワーク

MediaPipe フレームワークを使用して Android サンプルアプリをビルドする手順は次のとおりです。 これらのサンプルアプリの詳細については、Android の Hello World! をご覧ください。

Bazel を使用した Android サンプルアプリの構築

前提条件

  • こちらのinstructionsに沿って MediaPipe Framework をインストールします。
  • Java ランタイムを設定します。
  • Android SDK リリース 30.0.0 以降をセットアップします。
  • Android NDK のバージョンが 18 ～ 21 であること。

MediaPipe では、Android Studio を使用して Android SDK と NDK をセットアップすることをおすすめします（Android Studio のセットアップについては、下記をご覧ください）。ただし、Android Studio を使用せずに MediaPipe を使用する場合は、Android サンプルアプリを構築する前に、setup_android_sdk_and_ndk.sh を実行して Android SDK と NDK のダウンロードとセットアップを行ってください。

Android SDK と NDK がすでに（Android Studio によって）インストールされている場合は、インストールされている SDK と NDK を参照するように $ANDROID_HOME と $ANDROID_NDK_HOME を設定します。

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 レベルに切り替える必要があります。そのためには、android_ndk_repository() または WORKSPACE ファイルの android_sdk_repository() で api_level = $YOUR_INTENDED_API_LEVEL を指定します。

  1. Android サンプルアプリをビルドするには、対応する android_binary ビルド ターゲットに対してビルドします。たとえば、MediaPipe Hands の場合、ターゲットは BUILD ファイルの handtrackinggpu です。

    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