Vui lòng làm theo hướng dẫn bên dưới để tạo các ứng dụng mẫu Android bằng Khung MediaPipe.
Để tìm hiểu thêm về các ứng dụng mẫu này, hãy bắt đầu từ Hello World! trên Android.
Thiết lập bản phát hành SDK Android 35.0.0 trở lên.
Thiết lập Android NDK phiên bản 28 trở lên.
MediaPipe đề xuất thiết lập Android SDK và NDK thông qua Android Studio (xem phần thiết lập Android Studio bên dưới). Tuy nhiên, nếu bạn muốn sử dụng MediaPipe mà không cần Android Studio, vui lòng chạy setup_android_sdk_and_ndk.sh để tải xuống và thiết lập Android SDK và NDK trước khi tạo bất kỳ ứng dụng mẫu nào trên Android.
Nếu bạn đã cài đặt SDK và NDK Android (ví dụ: bằng Android Studio), hãy đặt $ANDROID_HOME và $ANDROID_NDK_HOME để trỏ đến SDK và NDK đã cài đặt.
Để sử dụng Framework trên các phiên bản Android cũ, MediaPipe cần chuyển sang cấp độ API Android thấp hơn. Bạn có thể thực hiện việc này bằng cách chỉ định api_level =
$YOUR_INTENDED_API_LEVEL trong android_ndk_repository() và/hoặc android_sdk_repository() trong tệp WORKSPACE.
Để tạo một ứng dụng mẫu Android, hãy tạo dựa trên mục tiêu tạo android_binary tương ứng. Ví dụ: đối với MediaPipe Hands, mục tiêu là handtrackinggpu trong tệp BUILD:
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-24 UTC."],[],[],null,["# MediaPipe Framework on Android\n\nPlease follow instructions below to build Android example apps with MediaPipe Framework.\nTo learn more about these example apps, start from [Hello World! on\nAndroid](./hello_world_android.md).\n\nBuilding Android example apps with Bazel\n----------------------------------------\n\n### Prerequisite\n\n- Install MediaPipe Framework following these [instructions](./install.md).\n- Setup Java Runtime.\n- Setup Android SDK release 35.0.0 or later.\n- Setup Android NDK version 28 or later.\n\nMediaPipe recommends setting up Android SDK and NDK via Android Studio (and see\nbelow for Android Studio setup). However, if you prefer using MediaPipe without\nAndroid Studio, please run\n[`setup_android_sdk_and_ndk.sh`](https://github.com/google/mediapipe/blob/master/setup_android_sdk_and_ndk.sh)\nto download and setup Android SDK and NDK before building any Android example\napps.\n\nIf Android SDK and NDK are already installed (e.g., by Android Studio), set\n`$ANDROID_HOME` and `$ANDROID_NDK_HOME` to point to the installed SDK and NDK. \n\n export ANDROID_HOME=\u003cpath to the Android SDK\u003e\n export ANDROID_NDK_HOME=\u003cpath to the Android NDK\u003e\n\nand add `android_ndk_repository()`, `android_sdk_repository()` and `bind()`\nrules into the\n[`WORKSPACE`](https://github.com/google/mediapipe/blob/master/WORKSPACE) file as\nthe following: \n\n $ echo \"android_sdk_repository(name = \\\"androidsdk\\\")\" \u003e\u003e WORKSPACE\n $ echo \"android_ndk_repository(name = \\\"androidndk\\\", api_level=26)\" \u003e\u003e WORKSPACE\n $ echo \"bind(name = \\\"android/crosstool\\\", actual = \\\"@androidndk//:toolchain\\\")\" \u003e\u003e WORKSPACE\n\nIn order to use Framework on earlier Android versions, MediaPipe needs to switch\nto a lower Android API level. You can achieve this by specifying `api_level =\n$YOUR_INTENDED_API_LEVEL` in android_ndk_repository() and/or\nandroid_sdk_repository() in the\n[`WORKSPACE`](https://github.com/google/mediapipe/blob/master/WORKSPACE) file.\n| **Tip:** You can run this [script](https://github.com/google/mediapipe/blob/master/build_android_examples.sh) to build (and install) all MediaPipe Android example apps.\n\n1. To build an Android example app, build against the corresponding\n `android_binary` build target. For instance, for MediaPipe Hands the target\n is `handtrackinggpu` in the\n [BUILD](https://github.com/google/mediapipe/tree/master/mediapipe/examples/android/src/java/com/google/mediapipe/apps/handtrackinggpu/BUILD)\n file:\n\n **Note:** To reduce the binary size, consider appending `--linkopt=\"-s\"` to the command below to strip symbols. \n\n bazel build -c opt --config=android_arm64 mediapipe/examples/android/src/java/com/google/mediapipe/apps/handtrackinggpu:handtrackinggpu\n\n2. Install it on a device with:\n\n adb install bazel-bin/mediapipe/examples/android/src/java/com/google/mediapipe/apps/handtrackinggpu/handtrackinggpu.apk"]]
