Jalur penginstalan model ML Kit di Android

Semua fitur ML Kit memanfaatkan model machine learning yang dilatih Google (dikenal sebagai model dasar) secara default. Panduan ini hanya berlaku untuk model dasar. Lihat di sini untuk mendapatkan panduan tentang model kustom.

Model di ML Kit API dapat diinstal dengan salah satu dari tiga cara berikut:

  1. Tidak dipaketkan: Model didownload dan dikelola melalui Layanan Google Play.
  2. Paket: Model ditautkan secara statis ke aplikasi Anda pada waktu build.
  3. 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 ML Fitur kit:

Tidak dikelompokkan Paket 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 ✅ ✅
Translation ✅
Smart Reply ✅ ✅
Ekstraksi Entity ✅

Panduan khusus API menunjukkan opsi penginstalan yang tersedia untuk Compute Engine API.

Perbedaan utama antara berbagai opsi penginstalan

Tidak dikelompokkan Paket Didownload secara dinamis
Di mana model disimpan? Berada di Layanan Google Play dan tidak dihitung dalam penyimpanan digunakan oleh aplikasi ini Disimpan di penyimpanan khusus aplikasi setelah penginstalan Disimpan di penyimpanan khusus aplikasi download model setelah
Bagaimana pengaruh ukuran model terhadap ukuran aplikasi? Tidak berkontribusi pada ukuran aplikasi Berkontribusi langsung terhadap ukuran aplikasi Tidak berkontribusi pada ukuran aplikasi, tetapi meningkatkan penyimpanan khusus aplikasi
Kapan model diperbarui? Otomatis diperbarui saat versi yang lebih baru dirilis Perlu mengupdate aplikasi untuk mengupdate model Perlu mengupdate aplikasi untuk mengupdate model
Kapan model didownload? Model harus didownload sebelum digunakan Semua model dan fitur disertakan saat aplikasi diinstal, sehingga dapat segera 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 di-uninstal Model dihapus dari penyimpanan khusus aplikasi kapan aplikasi di-uninstal Model yang didownload akan dihapus dari penyimpanan khusus aplikasi kapan aplikasi di-uninstal

Cara memilih antara paket yang dipaketkan dan tidak dipaketkan

Jika API mendukung opsi penginstalan yang dipaketkan dan tidak dipaketkan:

  • Gunakan opsi paket jika Anda mengatur prioritas:

    • Menyelesaikan 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

Saat menggunakan opsi model yang tidak dipaketkan, Anda dapat menentukan cara model diunduh 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 untuk mengunduh Kode Batang secara otomatis Model pemindaian 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 Layanan Google Play ModuleInstallClient API.

  • Jika Anda tidak mengaktifkan download model waktu penginstalan atau permintaan eksplisit model akan diunduh saat pertama kali Anda menjalankan fitur. Permintaan inferensi akan gagal hingga download selesai.

Cara mengupdate model

Untuk mengupdate model saat menggunakan model paket atau model yang didownload secara dinamis opsi model:

  1. Mengupdate file gradle aplikasi untuk menggunakan klien fitur ML Kit terbaru library.

    dependencies {
  implementation 'com.google.mlkit:barcode-scanning: 17.2.0' // The latest version number of the API
}

  2. 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, Tinta digital pengenalan mendukung 300+ bahasa, dan ini tidak selalu diperlukan untuk menempatkan setiap bahasa ke dalam fitur selama instalasi. Untuk tujuan itu, kami menyediakan opsi instalasi ketiga, dengan model diunduh sesuai permintaan setelah pemasangan. Saat ini, hanya Tinta digital pengenalan objek, Translation dan Entity ekstraksi data memiliki opsi ini.