Android'de ML Kiti model yükleme yolları

Tüm Makine Öğrenimi Kiti özellikleri, varsayılan olarak Google tarafından eğitilmiş makine öğrenimi modellerini (temel modeller olarak bilinir) kullanır. Bu kılavuz yalnızca temel modeller için geçerlidir. Özel modellerle ilgili yardım için buraya bakın.

ML Kit API'lerindeki modeller şu üç yöntemden biriyle yüklenebilir:

  1. Grup halinde olmayanlar: Modeller, Google Play Hizmetleri üzerinden indirilir ve yönetilir.
  2. Paket: Modeller, derleme sırasında statik olarak uygulamanıza bağlıdır.
  3. Dinamik olarak indirildi: Modeller isteğe bağlı olarak indirilir.

Her API için desteklenen yükleme yolları

Aşağıdaki tabloda, her bir ML Kit özelliği tarafından desteklenen model yükleme yolları gösterilmektedir:

Grup halinde olmayan Paket Dinamik olarak indirildi
Metin tanıma v2 ✅ ✅
Yüz algılama ✅ ✅
Yüz ağı algılama ✅
Konum algılama ✅
Selfie segmentasyonu ✅
Barkod tarama ✅ ✅
Resim etiketleme ✅ ✅
Nesne algılama ve izleme ✅
Dijital mürekkep tanıma ✅
Belge tarayıcı ✅
Konu segmentasyonu ✅
Google kod tarayıcı ✅
Dil tanımlama ✅ ✅
Translation ✅
Akıllı Yanıt ✅ ✅
Varlık Ayıklama ✅

API'ye özel kılavuzlar, belirli bir API için hangi yükleme seçeneklerinin kullanılabildiğini gösterir.

Yükleme seçenekleri arasındaki temel farklar

Grup halinde olmayan Gruplandırılmış Dinamik olarak indirildi
Modeller nerede depolanır? Google Play Hizmetleri'nde yer alır ve bu uygulama tarafından kullanılan depolama alanı hesaplamasına dahil edilmez Yükleme sonrasında uygulamaya özel depolama alanına kaydedilir Model indirildikten sonra uygulamaya özel depolama alanına kaydedildi
Model boyutu uygulama boyutunu nasıl etkiler? Uygulama boyutuna katkıda bulunmaz Uygulama boyutuna doğrudan katkıda bulunur Uygulama boyutuna katkıda bulunmaz ancak uygulamaya özel depolama alanını artırır
Modeller ne zaman güncellenir? Daha yeni bir sürüm yayınlandığında otomatik olarak güncellenir Modeli güncellemek için uygulamanın güncellenmesi gerekiyor Modeli güncellemek için uygulamanın güncellenmesi gerekiyor
Modeller ne zaman indirilir? Modeller kullanılmadan önce indirilmelidir Tüm modeller ve özellikler uygulama yüklendiğinde içerdiği için hemen kullanılabilir. Model indirme, güncelleme ve silme işlemleri RemoteModelManager API kullanılarak manuel olarak yönetilmelidir
Modeller cihazdan ne zaman kaldırılır? Google Play Hizmetleri, yalnızca modele bağlı tüm uygulamaların yüklemesi kaldırılırsa modeli depolama alanından kaldırır Uygulama kaldırıldığında modeller uygulamaya özel depolama alanından kaldırılır İndirilen modeller, uygulama kaldırıldığında uygulamaya özel depolama alanından kaldırılır.

Gruplandırılmış ve gruplanmamış arasında seçim yapma

Bir API hem paket halinde sunulan hem de paketlenmemiş yükleme seçeneklerini destekliyorsa:

  • Şunlara öncelik veriyorsanız gruplananlar seçeneğini kullanın:

    • Uygulama yüklendikten hemen sonra özellik işlevini tamamlayın
    • Uygulama yüklendikten sonra ağ bağlantısı olmadan özellik işlevselliği

  • Şunlara öncelik veriyorsanız grup halinde olmayanlar seçeneğini kullanın:

    • Daha küçük uygulama boyutu
    • Google Play Hizmetleri tarafından otomatik model güncellemeleri

Modelleri indirme

Grup halinde olmayan model seçeneğini kullanırken modellerin cihaza nasıl indirilmesini istediğinizi belirtebilirsiniz:

  • Uygulamanızın AndroidManifest.xml dosyasına bir bildirim ekleyerek yükleme zamanı modeli indirmelerini etkinleştirebilirsiniz. Örneğin, aşağıdaki kod snippet'inde, uygulamanız Play Store'dan yüklendikten sonra Barkod Tarama modelini otomatik olarak indirecek şekilde nasıl yapılandıracağınız gösterilmektedir:

    <application ...>
      ...
      <meta-data
          android:name="com.google.mlkit.vision.DEPENDENCIES"
          android:value="barcode" >
      <!-- To use multiple models: android:value="barcode,model2,model3" -->
</application>

  • Google Play Hizmetleri ModuleInstallClient API üzerinden açık bir şekilde indirme isteyebilirsiniz.

  • Yükleme zamanı modeli indirmelerini etkinleştirmezseniz veya açık bir şekilde indirme isteğinde bulunmazsanız model, özelliği ilk çalıştırdığınızda indirilir. İndirme işlemi tamamlanana kadar çıkarım istekleri başarısız olur.

Modelleri güncelleme

Paketlenmiş modeli veya dinamik olarak indirilen modeller seçeneğini kullanırken modellerinizi güncellemek için:

  1. En yeni Makine Öğrenimi Kiti özellik istemci kitaplığını kullanmak için uygulamanızın gradle dosyasını güncelleyin.

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

  2. Uygulamanızı yeniden oluşturun.

Neden bazı API'ler dinamik olarak indirilen modeller sunuyor?

Bazı ML Kit API'lerinde paket haline getirilebilecek çok fazla model seçeneği vardır. Örneğin, Dijital mürekkep tanıma 300'den fazla dili destekler ve kurulum sırasında her zaman özelliğin içine her dilin eklenmesi gerekmez. Bu amaçla, modellerin kurulumdan sonra isteğe bağlı olarak indirildiği üçüncü kurulum seçeneğini sağlıyoruz. Şu anda yalnızca Dijital mürekkep tanıma, Çeviri ve Varlık çıkarma seçeneği sunulmaktadır.