Android'de ML Kit modeli yükleme yolları

Tüm ML Kit ö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 modeller hakkında rehberlik için buraya bakın.

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

  1. Gruplandırılmamış: Modeller Google Play Hizmetleri aracılığıyla indirilir ve yönetilir.
  2. Gruplandırılmış: Modeller, derleme sırasında uygulamanıza statik olarak bağlanır.
  3. Dinamik olarak indirilir: Modeller isteğe bağlı olarak indirilir.

Her API için desteklenen yükleme yolları

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

Gruplandırılmamış Paketlenmiş Dinamik olarak indirildi
Metin tanıma v2 ✅ ✅
Yüz algılama ✅ ✅
Yüz ağı algılama ✅
Poz algılama ✅
Selfie segmentasyonu ✅
Barkod tarama ✅ ✅
Resim etiketleme ✅ ✅
Nesne algılama ve izleme ✅
Dijital mürekkep tanıma ✅
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ılabileceğini gösterir.

Yükleme seçenekleri arasındaki temel farklar

Gruplandırılmamış Paket halinde Dinamik olarak indirildi
Modeller nerede depolanır? Google Play Hizmetleri'nde bulunur ve bu uygulamanın kullandığı depolama alanı kotasında hesaba katılmaz Yüklemeden sonra uygulamaya özel depolama alanına kaydedildi Model indirildikten sonra uygulamaya özel depolama alanına kaydedildi
Model boyutu uygulama boyutunu nasıl etkiler? Uygulama boyutuna katkı sağlamaz Uygulama boyutuna doğrudan katkıda bulunur Uygulama boyutuna doğrudan katkıda bulunur
Modeller ne zaman güncellenir? Daha yeni bir sürüm yayınlandığında otomatik olarak güncellenir Modeli güncellemek için uygulamayı güncellemeniz gerekiyor Modeli güncellemek için uygulamayı güncellemeniz gerekiyor
Modeller ne zaman indirilir? Kullanımdan önce modellerin indirilmesi gerekir Uygulama yüklenirken tüm modeller ve özellikler dahil edilir, böylece anında kullanılabilir Model indirmeleri, güncellemeleri ve silme işlemleri, RemoteModelManager API'si 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ış öğeler arasında seçim yapma

API hem paket halinde hem de grup halinde olmayan yükleme seçeneklerini destekliyorsa:

  • Aşağıdaki ölçütlere öncelik veriyorsanız gruplandırılmış seçeneği kullanın:

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

  • Aşağıdakilere öncelik verirseniz grup halinde olmayan seçeneği kullanın:

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

Modeller nasıl indirilir?

Paket 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ı model indirmelerini etkinleştirebilirsiniz. Örneğin, aşağıdaki kod snippet'i, uygulamanız Play Store'dan yüklendikten sonra Barkod Tarama modelini otomatik olarak indirecek şekilde uygulamanızı nasıl yapılandıracağınızı gösterir:

    <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 indirme isteğinde bulunabilirsiniz.

  • Yükleme sırasında model indirmeleri etkinleştirmezseniz veya açık indirme isteğinde bulunmazsanız ilgili özellik ilk kez çalıştırıldığında model indirilir. İndirme işlemi tamamlanana kadar, çıkarım istekleri başarısız olur.

Modeller nasıl güncellenir?

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

  1. Uygulamanızın gradle dosyasını, en son ML Kit özellik istemci kitaplığını kullanacak şekilde güncelleyin.

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

  2. Uygulamanızı yeniden oluşturun.

Bazı API'ler neden dinamik olarak indirilen modeller sunar?

Bazı ML Kit API'sinde paketlenecek çok fazla model seçeneği var. Örneğin, dijital mürekkep tanıma 300'den fazla dili destekler. Yükleme sırasında her dilin kullanılması her zaman gerekli değildir. Bu amaçla, modellerin kurulumdan sonra isteğe bağlı olarak indirildiği üçüncü yükleme seçeneğini sunuyoruz. Şu anda yalnızca dijital mürekkep tanıma, Çeviri ve Varlık çıkarma seçenekleri bulunmaktadır.