Halaman ini menunjukkan cara menyiapkan lingkungan pengembangan untuk menggunakan MediaPipe Tasks di aplikasi Android.
Perangkat dan platform yang didukung
Untuk membuat aplikasi Android dengan MediaPipe Tasks, lingkungan pengembangan Anda memerlukan hal-hal berikut:
- Android Studio dengan versi yang direkomendasikan minimal 2021.1.1 (Bumblebee), atau IDE lain yang kompatibel.
- Android SDK versi 24 atau yang lebih tinggi
- Perangkat Android dengan setidaknya versi SDK minimum. Emulator Android mungkin tidak berfungsi untuk semua tugas.
Penyiapan lingkungan developer
Sebelum menjalankan tugas MediaPipe di aplikasi Android, Anda harus sudah memiliki aplikasi yang sudah ada atau membuat project Android Studio baru di komputer lokal. MediaPipe sesuai dengan Lapisan data aplikasi Anda, yang berisi data aplikasi dan logika bisnis. Untuk informasi selengkapnya tentang arsitektur aplikasi Android, lihat Panduan arsitektur aplikasi.
Penyiapan perangkat Android
Anda harus mengaktifkan Opsi developer dan proses debug USB di perangkat Android fisik sebelum menggunakannya untuk menguji aplikasi Anda. Untuk mengetahui petunjuk cara mengonfigurasi perangkat dengan Opsi developer, lihat Mengonfigurasi opsi developer di perangkat.
Untuk tugas yang tidak memerlukan kamera atau mikrofon perangkat, Anda dapat menggunakan emulator perangkat Android, bukan perangkat Android fisik. Untuk petunjuk menyiapkan Android Emulator, lihat Menjalankan aplikasi di Android Emulator.
Contoh penyiapan kode
Repositori MediaPipe Examples berisi contoh aplikasi Android untuk setiap tugas MediaPipe. Anda dapat membuat project dari kode contoh, membuat project, lalu menjalankannya.
Untuk mengimpor dan membangun project kode contoh:
- Mulai Android Studio.
- Dari Android Studio, pilih File > New > Import Project.
- Buka direktori kode contoh yang berisi file
build.gradle
, lalu pilih direktori tersebut, misalnya:.../mediapipe/examples/text_classification/android/build.gradle
- Jika Android Studio meminta Sinkronisasi Gradle, pilih Oke.
- Pastikan perangkat Android Anda terhubung ke komputer dan mode
developer diaktifkan. Klik panah
Run
hijau.
Jika Anda memilih direktori yang benar, Android Studio akan membuat project baru dan
mem-build-nya. Proses ini dapat memerlukan waktu beberapa menit, bergantung pada kecepatan komputer
dan apakah Anda telah menggunakan Android Studio untuk project lain. Setelah build
selesai, Android Studio akan menampilkan pesan BUILD SUCCESSFUL
di
panel status Build Output.
Untuk menjalankan project:
- Dari Android Studio, jalankan project dengan memilih Run > Run....
- Pilih perangkat Android (atau emulator) yang terpasang untuk menguji aplikasi.
Dependensi Tugas MediaPipe
MediaPipe Tasks menyediakan tiga library bawaan untuk visi, teks, audio. File
model .tflite
harus berada di direktori aset modul
Android yang menggunakan model tersebut. Bergantung pada MediaPipe Task yang digunakan oleh aplikasi, tambahkan
library visi, teks, atau audio ke daftar dependensi dalam
file build.gradle
.
Tugas AI generatif
Library AI Generatif MediaPipe Tasks berisi tugas yang menangani pembuatan gambar atau
teks. Untuk mengimpor library AI Generatif MediaPipe Tasks di
Android Studio, tambahkan dependensi ke file build.gradle
Anda.
Pembuat Gambar
Tugas Generator Gambar MediaPipe terdapat dalam
library tasks-vision-image-generator
. Tambahkan dependensi ke
file build.gradle
Anda:
dependencies {
implementation 'com.google.mediapipe:tasks-vision-image-generator:latest.release'
}
API Inferensi LLM
Tugas Inferensi LLM MediaPipe terdapat dalam library
tasks-genai
. Tambahkan dependensi ke file build.gradle
Anda:
dependencies {
implementation 'com.google.mediapipe:tasks-genai:latest.release'
}
Tugas visi
Library Vision MediaPipe Tasks berisi tugas yang menangani input gambar atau
video. Untuk mengimpor library Vision MediaPipe Tasks di Android Studio, tambahkan
dependensi berikut ke file build.gradle
Anda:
dependencies {
implementation 'com.google.mediapipe:tasks-vision:latest.release'
}
Tugas teks
Library teks MediaPipe Tasks berisi tugas yang menangani data bahasa dalam
format teks. Untuk mengimpor library teks MediaPipe Tasks di Android Studio, tambahkan
dependensi berikut ke file build.gradle
Anda:
dependencies {
implementation 'com.google.mediapipe:tasks-text:latest.release'
}
Tugas audio
Library audio MediaPipe Tasks berisi tugas yang menangani input suara. Untuk
mengimpor library audio MediaPipe Tasks di Android Studio, tambahkan dependensi
berikut ke file build.gradle
Anda:
dependencies {
implementation 'com.google.mediapipe:tasks-audio:latest.release'
}
Konfigurasi BaseOptions
BaseOptions
memungkinkan konfigurasi umum MediaPipe Task API.
Nama opsi | Deskripsi | Nilai yang diterima |
---|---|---|
modelAssetBuffer |
Konten file aset model sebagai ByteBuffer atau MappedByteBuffer langsung. |
ByteBuffer atau MappedByteBuffer sebagai string |
modelAssetPath |
Jalur model ke file aset model di folder aset aplikasi Android. | Jalur file sebagai string |
modelAssetFileDescriptor |
Bilangan bulat deskriptor file native dari file aset model. | Bilangan bulat yang menentukan deskriptor file |
Delegate |
Mengaktifkan akselerasi hardware melalui delegasi perangkat untuk menjalankan pipeline MediaPipe. Nilai default: CPU . |
[CPU ,GPU ] |
Akselerasi hardware
MediaPipe Tasks mendukung penggunaan unit pemrosesan grafis (GPU) untuk menjalankan model machine learning. Di perangkat Android, Anda dapat mengaktifkan penggunaan eksekusi model yang dipercepat GPU menggunakan delegasi. Delegasi bertindak sebagai driver hardware untuk MediaPipe, sehingga Anda dapat menjalankan model di prosesor GPU, bukan prosesor CPU standar.
Konfigurasikan delegasi GPU dalam opsi tugas melalui BaseOptions
:
BaseOptions baseOptions = BaseOptions.builder().useGpu().build();
Pemecahan masalah
Untuk mendapatkan bantuan terkait pertanyaan teknis terkait MediaPipe, kunjungi grup diskusi atau Stack Overflow untuk mendapatkan dukungan dari komunitas. Untuk melaporkan bug atau mengajukan permintaan fitur, ajukan masalah di GitHub.
Untuk mendapatkan bantuan dalam menyiapkan lingkungan pengembangan Android Anda, buka dokumentasi developer Android.