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:
- Grup halinde olmayanlar: Modeller, Google Play Hizmetleri üzerinden indirilir ve yönetilir.
- Paket: Modeller, derleme sırasında statik olarak uygulamanıza bağlıdır.
- 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:
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 }
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.