Android'de ML Kiti model 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 bilgi edinmek için buraya göz atın.

ML Kit API'lerindeki modeller üç şekilde yüklenebilir:

  1. Paketlenmemiş: Modeller Google Play Hizmetleri aracılığıyla indirilir ve yönetilir.
  2. Paketlenmiş: 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 kurulum yolları

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

Paketsiz Gruplandırılmış Dinamik olarak indirilen
Metin tanıma v2 ✅ ✅
Yüz algılama ✅ ✅
Yüz örgüsü algılama ✅
Poz algılama ✅
Selfie segmentasyonu ✅
Barkod taraması ✅ ✅
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 API için hangi yükleme seçeneklerinin kullanılabileceğini gösterir.

Yükleme seçenekleri arasındaki temel farklar

Paketsiz Gruplandırılmış Dinamik olarak indirilen
Modeller nerede depolanır? Google Play Hizmetleri'nde bulunur ve bu uygulama tarafından kullanılan depolama alanına dahil edilmez Yüklemeden sonra uygulamaya özel depolama alanına kaydedilir Model indirildikten sonra uygulamaya özel depolama alanına kaydedilir.
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 özgü 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 Uygulama yüklendiğinde tüm modeller ve özellikler dahil edilir, bu nedenle hemen kullanılabilir. Model indirme, güncelleme ve silme işlemleri RemoteModelManager API'si kullanılarak manuel olarak yönetilmelidir
Modeller ne zaman cihazdan kaldırılır? Google Play Hizmetleri, modeli yalnızca modele bağlı tüm uygulamalar kaldırılırsa depolama alanından kaldırır. Uygulama yüklemesi kaldırıldığında modeller uygulamaya özel depolama alanından kaldırılır İndirilen modeller, uygulamanın yüklenmesi kaldırıldığında uygulamaya özgü depolama alanından kaldırılır

Paketlenmiş ve paketlenmemiş arasında seçim yapma

Bir API hem paketlenmiş hem de paketlenmemiş yükleme seçeneklerini destekliyorsa:

  • Aşağıdakilere öncelik veriyorsanız paket seçeneğini kullanın:

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

  • Aşağıdakilere öncelik veriyorsanız paketsiz seçeneği kullanın:

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

Modelleri indirme

Paketlenmemiş model seçeneğini kullanırken modellerin cihaza nasıl indirilmesini istediğinizi belirtebilirsiniz:

  • Uygulamanızın AndroidManifest.xml dosyasına bir beyan ekleyerek yükleme sırasında model indirme özelliğini etkinleştirebilirsiniz. Örneğin, aşağıdaki kod snippet'inde uygulamanızın Play Store'dan yüklendikten sonra Barcode Scanner modelini otomatik olarak indirmesi için 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 aracılığıyla açık indirme isteğinde bulunabilirsiniz.

  • Yükleme sırasında model indirmelerini etkinleştirmezseniz veya açık indirme isteğinde bulunmazsanız model, özelliği ilk kez ç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. 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.3.0' // The latest version number of the API
}

  2. Uygulamanızı yeniden oluşturun.

Bazı API'lerin dinamik olarak indirilen modeller sunmasının nedeni

Bazı ML Kit API'lerinde gruplandırılacak ç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 dili bu özelliğe eklemek her zaman gerekli değildir. Bu amaçla, modellerin kurulumdan sonra isteğe bağlı olarak indirildiği üçüncü bir yükleme seçeneği sunuyoruz. Şu anda yalnızca Dijital mürekkep tanıma, çeviri ve varlık ayıklama için bu seçenek mevcuttur.