Ścieżki instalacji modelu ML Kit na Androidzie

Wszystkie funkcje ML Kit wykorzystują modele systemów uczących się wytrenowane przez Google modeli podstawowych). Ten przewodnik dotyczy tylko modeli podstawowych. Zobacz tutaj , gdzie znajdziesz wskazówki dotyczące modeli niestandardowych.

Modele w interfejsach ML Kit API można instalować na 3 sposoby:

  1. Niegrupowane: modele są pobierane i zarządzane przez Usługi Google Play.
  2. W pakiecie: modele są statycznie połączone z aplikacją w momencie kompilacji.
  3. Pobieraj dynamicznie: modele są pobierane na żądanie.

Obsługiwane ścieżki instalacji dla każdego interfejsu API

Tabela poniżej pokazuje, które ścieżki instalacji modeli są obsługiwane przez poszczególne systemy uczące się Funkcja pakietu:

Niegrupowane W pakiecie Dynamiczne pobieranie
Rozpoznawanie tekstu (wersja 2) ✅ ✅
Wykrywanie twarzy ✅ ✅
Wykrywanie siatki twarzy ✅
Wykrywanie pozycji ✅
Segmentowanie selfie ✅
Skanowanie kodów kreskowych ✅ ✅
Oznaczanie obrazów etykietami ✅ ✅
Wykrywanie i śledzenie obiektów ✅
Rozpoznawanie cyfrowego atramentu ✅
Skaner dokumentów ✅
Podział na segmenty według tematu ✅
Skaner kodów Google ✅
Identyfikacja języka ✅ ✅
Tłumaczenie ✅
Inteligentna odpowiedź ✅ ✅
Ekstrakcja encji ✅

Przewodniki dotyczące interfejsów API pokazują, jakie opcje instalacji są dostępne dla danego API.

Najważniejsze różnice między opcjami instalacji

Niegrupowane W pakiecie Dynamiczne pobieranie
Gdzie są przechowywane modele? Jest powiązany z Usługami Google Play i nie jest wliczany do limitu miejsca na dane. używane przez tę aplikację Zapisane w pamięci aplikacji po instalacji Zapisane w pamięci aplikacji po pobraniu modelu
Jak rozmiar modelu wpływa na rozmiar aplikacji? Nie wpływa na rozmiar aplikacji Bezpośrednio wpływa na rozmiar aplikacji Nie wpływa na rozmiar aplikacji, ale zwiększa miejsce na dane aplikacji
Kiedy modele są aktualizowane? Aktualizowane automatycznie po opublikowaniu nowszej wersji Aby zaktualizować model, musisz zaktualizować aplikację Aby zaktualizować model, musisz zaktualizować aplikację
Kiedy są pobierane modele? Modele należy pobrać przed użyciem Wszystkie modele i funkcje są dostępne w momencie instalacji aplikacji, więc można ich używać od razu. Pobieraniem, aktualizowaniem i usuwaniem modeli trzeba zarządzać ręcznie za pomocą RemoteModelManager Interfejs API
Kiedy modele są usuwane z urządzenia? Usługi Google Play usunie model z pamięci tylko wtedy, gdy wszystkie aplikacje zależne od modelu, są odinstalowane, Modele są usuwane z pamięci aplikacji podczas odinstalowania aplikacji. Pobrane modele są usuwane z pamięci aplikacji. podczas odinstalowania aplikacji.

Jak wybrać wersję łączoną i niezbiorczą

Jeśli interfejs API obsługuje opcje instalacji zarówno w pakiecie, jak i bez niego:

  • Użyj opcji pakietu, jeśli priorytetowo traktujesz:

    • Pełna funkcjonalność funkcji natychmiast po zainstalowaniu aplikacji
    • Funkcja działa bez połączenia sieciowego po zainstalowaniu aplikacji

  • Użyj opcji niegrupowej, jeśli priorytetowo traktujesz:

    • Mniejszy rozmiar aplikacji
    • Automatyczne aktualizacje modeli przez Usługi Google Play

Jak pobierać modele

Gdy używasz opcji modelu niezgrupowanego, możesz określić, jak mają wyglądać modele pobrane na urządzenie:

  • Możesz włączyć pobieranie modelu podczas instalacji, dodając deklarację do: do pliku AndroidManifest.xml aplikacji. Na przykład w poniższym fragmencie kodu pokazuje, jak skonfigurować automatyczne pobieranie kodu kreskowego w aplikacji Skanowanie modelu po zainstalowaniu aplikacji ze Sklepu Play:

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

  • W Usługach Google Play możesz poprosić o wyraźne pobranie Interfejs API ModuleInstallClient.

  • Jeśli nie włączysz pobierania modeli w czasie instalacji lub nie poprosisz o treści dla pełnoletnich podczas pobierania model zostanie pobrany przy pierwszym uruchomieniu tej funkcji. Dopóki pobieranie nie zostanie ukończone, żądania wnioskowania będą się kończyć niepowodzeniem.

Jak aktualizować modele

Aby zaktualizować modele w przypadku korzystania z modelu dołączanego do pakietu lub pobieranego dynamicznie opcja modeli:

  1. Zaktualizuj plik Gradle aplikacji, aby używać najnowszego klienta funkcji ML Kit bibliotece.

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

  2. Ponownie skompiluj aplikację.

Dlaczego niektóre interfejsy API udostępniają modele pobierane dynamicznie

Niektóre interfejsy ML Kit API mają zbyt wiele opcji modeli, aby je połączyć w pakiet. Na przykład Tusze cyfrowe rozpoznawanie obsługuje 300+ i nie jest zawsze konieczne jest umieszczenie każdego języka wewnątrz funkcji podczas instalacji. Dlatego udostępniamy trzecią opcję instalacji, w której modele są pobierane na żądanie po instalacji. Obecnie tylko atramenty cyfrowe rozpoznawanie twarzy, Tłumaczenie i Element