Semua fitur ML Kit menggunakan model machine learning yang dilatih Google (dikenal sebagai model dasar) secara default. Panduan ini hanya berlaku untuk model dasar. Lihat panduan tentang model kustom di sini.
Model dalam API ML Kit dapat diinstal dengan salah satu dari tiga cara berikut:
- Tidak Dipaketkan: Model didownload dan dikelola melalui Layanan Google Play.
- Dipaketkan: Model ditautkan secara statis ke aplikasi Anda pada waktu build.
- Didownload secara dinamis: Model didownload sesuai permintaan.
Jalur penginstalan yang didukung untuk setiap API
Tabel di bawah menunjukkan jalur penginstalan model yang didukung oleh setiap fitur ML Kit:
Tidak Dipaketkan | Dipaketkan | Didownload secara dinamis | |
Pengenalan teks v2 | ✅ | ✅ | |
Deteksi wajah | ✅ | ✅ | |
Deteksi mesh wajah | ✅ | ||
Deteksi pose | ✅ | ||
Segmentasi selfie | ✅ | ||
Pemindaian kode batang | ✅ | ✅ | |
Pelabelan gambar | ✅ | ✅ | |
Deteksi dan pelacakan objek | ✅ | ||
Pengenalan tinta digital | ✅ | ||
Pemindai dokumen | ✅ | ||
Segmentasi subjek | ✅ | ||
Pemindai kode Google | ✅ | ||
Identifikasi bahasa | ✅ | ✅ | |
Terjemahan | ✅ | ||
Smart Reply | ✅ | ✅ | |
Ekstraksi Entity | ✅ |
Panduan khusus API menunjukkan opsi penginstalan yang tersedia untuk API tertentu.
Perbedaan utama antara berbagai opsi penginstalan
Tidak Dipaketkan | Dipaketkan | Didownload secara dinamis | |
Di mana model disimpan? | Berada di Layanan Google Play dan tidak dihitung dalam penyimpanan yang digunakan oleh aplikasi ini | Disimpan di penyimpanan khusus aplikasi setelah penginstalan | Disimpan di penyimpanan khusus aplikasi setelah download model |
Bagaimana pengaruh ukuran model terhadap ukuran aplikasi? | Tidak berkontribusi pada ukuran aplikasi | Berkontribusi secara langsung pada ukuran aplikasi | Tidak berkontribusi pada ukuran aplikasi, tetapi meningkatkan penyimpanan khusus aplikasi |
Kapan model diperbarui? | Otomatis diperbarui saat versi yang lebih baru dirilis | Aplikasi perlu diupdate untuk mengupdate model | Aplikasi perlu diupdate untuk mengupdate model |
Kapan model didownload? | Model harus didownload sebelum digunakan | Semua model dan fitur disertakan saat aplikasi diinstal, sehingga dapat langsung digunakan | Download, pembaruan, dan penghapusan model harus dikelola secara manual menggunakan RemoteModelManager API |
Kapan model dihapus dari perangkat? | Layanan Google Play hanya akan menghapus model dari penyimpanan jika semua aplikasi yang bergantung pada model tersebut di-uninstal | Model dihapus dari penyimpanan khusus aplikasi jika aplikasi di-uninstal | Model yang didownload akan dihapus dari penyimpanan khusus aplikasi saat aplikasi di-uninstal |
Cara memilih antara yang dipaketkan dan tidak dipaketkan
Jika API mendukung opsi penginstalan yang dipaketkan dan tidak dipaketkan:
Gunakan opsi paket jika Anda memprioritaskan:
- Melengkapi fungsi fitur segera setelah penginstalan aplikasi
- Fungsi fitur tanpa koneksi jaringan setelah penginstalan aplikasi
Gunakan opsi yang tidak dipaketkan jika Anda memprioritaskan:
- Ukuran aplikasi yang lebih kecil
- Update model otomatis oleh Layanan Google Play
Cara mendownload model
Ketika menggunakan opsi model yang tidak dipaketkan, Anda dapat menentukan cara model didownload ke perangkat:
Anda dapat mengaktifkan download model waktu penginstalan dengan menambahkan deklarasi ke file
AndroidManifest.xml
aplikasi Anda. Misalnya, cuplikan kode di bawah ini menunjukkan cara mengonfigurasi aplikasi Anda agar mendownload model Pemindaian Kode Batang secara otomatis setelah aplikasi Anda diinstal dari Play Store:<application ...> ... <meta-data android:name="com.google.mlkit.vision.DEPENDENCIES" android:value="barcode" > <!-- To use multiple models: android:value="barcode,model2,model3" --> </application>
Anda dapat meminta download eksplisit melalui ModuleInstallClient API Layanan Google Play.
Jika Anda tidak mengaktifkan download model waktu instal atau meminta download eksplisit, model akan didownload saat pertama kali Anda menjalankan fitur tersebut. Permintaan inferensi akan gagal hingga download selesai.
Cara memperbarui model
Untuk mengupdate model saat menggunakan model yang dipaketkan atau opsi model yang didownload secara dinamis:
Update file gradle aplikasi Anda untuk menggunakan library klien fitur ML Kit terbaru.
dependencies { implementation 'com.google.mlkit:barcode-scanning: 17.2.0' // The latest version number of the API }
Build ulang aplikasi Anda.
Alasan beberapa API menawarkan model yang didownload secara dinamis
Beberapa ML Kit API memiliki terlalu banyak opsi model untuk dipaketkan. Misalnya, Pengenalan tinta digital mendukung 300+ bahasa, dan tidak selalu perlu memasukkan setiap bahasa ke dalam fitur selama penginstalan. Untuk tujuan itu, kami menyediakan opsi penginstalan ketiga, dengan model didownload secara on demand setelah penginstalan. Saat ini, hanya Pengenalan tinta digital, Terjemahan, dan Ekstraksi entitas yang memiliki opsi ini.