Panduan penyiapan untuk Android

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:

  1. Mulai Android Studio.
  2. Dari Android Studio, pilih File > New > Import Project.
  3. Buka direktori kode contoh yang berisi file build.gradle, lalu pilih direktori tersebut, misalnya: .../mediapipe/examples/text_classification/android/build.gradle
  4. Jika Android Studio meminta Sinkronisasi Gradle, pilih Oke.
  5. 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:

  1. Dari Android Studio, jalankan project dengan memilih Run > Run....
  2. 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.