Panduan penyiapan untuk Android

Halaman ini menunjukkan cara menyiapkan lingkungan pengembangan untuk menggunakan MediaPipe Tugas-tugas di aplikasi Android Anda.

Perangkat dan platform yang didukung

Untuk membuat aplikasi Android dengan MediaPipe Tasks, pengembangan Anda lingkungan memerlukan hal berikut:

• Android Studio dengan versi yang direkomendasikan minimal 2021.1.1 (Bumblebee), atau versi lain yang kompatibel IDE.
• Android SDK versi 24 atau yang lebih baru
• Perangkat Android dengan setidaknya versi SDK minimum. Emulator Android mungkin tidak bekerja untuk semua tugas.

Penyiapan lingkungan developer

Sebelum menjalankan tugas MediaPipe pada aplikasi Android, Anda harus memiliki aplikasi yang ada atau buat project Android Studio baru di mesin lokal Anda. MediaPipe cocok dengan kolom Data lapisan aplikasi Anda, yang berisi data aplikasi dan logika bisnis. Untuk mengetahui informasi selengkapnya tentang Arsitektur aplikasi Android, lihat Panduan untuk aplikasi arsitektur ini.

Penyiapan perangkat Android

Anda harus mengaktifkan Opsi Developer dan proses debug USB di perangkat Android fisik sebelum menggunakannya untuk menguji aplikasi Anda. Untuk petunjuk tentang cara mengonfigurasi perangkat dengan Opsi developer, lihat Mengonfigurasi developer di perangkat lainnya.

Untuk tugas yang tidak memerlukan kamera atau mikrofon perangkat, Anda dapat menggunakan Emulator perangkat Android, bukan perangkat Android fisik. Untuk petunjuk cara menyiapkan Android Emulator, lihat Menjalankan aplikasi di Android Emulator.

Contoh penyiapan kode

MediaPipe Repositori contoh berisi contoh aplikasi Android untuk setiap tugas MediaPipe. Anda dapat membuat proyek dari kode contoh, membangun proyek, dan kemudian menjalankannya.

Untuk mengimpor dan membangun contoh proyek kode:

1. Mulai Android Studio.
2. Dari Android Studio, pilih File > Baru > Impor 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 OK.
5. Pastikan perangkat Android Anda terhubung ke komputer dan developer diaktifkan. Klik panah Run hijau.

Jika Anda memilih direktori yang benar, Android Studio akan membuat project baru dan membangunnya. Proses ini dapat memerlukan waktu beberapa menit, tergantung pada kecepatan komputer Anda dan jika Anda telah menggunakan Android Studio untuk proyek lain. Kapan 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 > Jalankan....
2. Pilih perangkat Android (atau emulator) yang terpasang untuk menguji aplikasi.

Dependensi Tugas MediaPipe

MediaPipe Tasks menyediakan tiga library bawaan untuk visi, teks, dan audio. Tujuan File model .tflite harus ditempatkan di direktori aset Android yang menggunakan model tersebut. Bergantung pada MediaPipe Task yang digunakan oleh aplikasi, tambahkan pustaka visi, teks, atau audio ke daftar dependensi dalam File build.gradle.

Tugas AI generatif

Library AI Generatif Tugas MediaPipe berisi tugas yang menangani gambar atau pembuatan teks. Untuk mengimpor library AI Generatif Tugas MediaPipe di Android Studio, tambahkan dependensi ke file build.gradle Anda.

Generator Gambar

Tugas MediaPipe Image Generator terdapat di dalam Library tasks-vision-image-generator. Tambahkan dependensi ke File build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-vision-image-generator:latest.release'
}

LLM Inference API

Tugas Inferensi LLM MediaPipe dimuat dalam tasks-genai library. Tambahkan dependensi ke file build.gradle Anda:

dependencies {
    implementation 'com.google.mediapipe:tasks-genai:latest.release'
}

Tugas penglihatan

Library visi Tugas MediaPipe berisi tugas yang menangani gambar atau video input. Untuk mengimpor library visi MediaPipe Tasks di Android Studio, tambahkan dependensi berikut ke file build.gradle Anda:

dependencies {
    implementation 'com.google.mediapipe:tasks-vision:latest.release'
}

Tugas teks

Pustaka teks MediaPipe Tasks berisi tugas yang menangani data bahasa di 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. Kepada impor library audio MediaPipe Tasks di Android Studio, tambahkan perintah berikut dependensi ke file build.gradle Anda:

dependencies {
    implementation 'com.google.mediapipe:tasks-audio:latest.release'
}

Konfigurasi BaseOptions

BaseOptions memungkinkan konfigurasi umum MediaPipe Task API.

Akselerasi hardware

MediaPipe Tasks mendukung penggunaan unit pemrosesan grafis (GPU) untuk menjalankan machine learning tertentu. Pada perangkat Android, Anda dapat mengaktifkan penggunaan Eksekusi model yang dipercepat oleh GPU menggunakan delegasi. Delegasi bertindak sebagai driver hardware untuk MediaPipe, yang memungkinkan Anda menjalankan model dengan GPU prosesor bukan prosesor CPU standar.

Konfigurasikan delegasi GPU dalam opsi tugas melalui BaseOptions:

BaseOptions baseOptions = BaseOptions.builder().useGpu().build();

Pemecahan masalah

Untuk bantuan terkait pertanyaan teknis terkait MediaPipe, kunjungi diskusi group atau Stack Overflow untuk dukungan dari bagi masyarakat. Untuk melaporkan bug atau mengajukan permintaan fitur, ajukan masalah di GitHub.

Untuk mendapatkan bantuan dalam menyiapkan lingkungan pengembangan Android Anda, buka situs Android dokumentasi developer kami.