Ścieżki instalacji modelu ML Kit na Androidzie

Wszystkie funkcje ML Kit domyślnie korzystają z modeli systemów uczących się wytrenowanych przez Google (tzw. modeli bazowych). 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. Pobranie dynamiczne: modele są pobierane na żądanie.

Obsługiwane ścieżki instalacji dla poszczególnych interfejsów API

Poniższa tabela pokazuje, które ścieżki instalacji modeli są obsługiwane przez poszczególne funkcje MLKit:

Nieskładane W pakiecie Dynamiczne pobieranie
Rozpoznawanie tekstu – wersja 2 ✅ ✅
Wykrywanie twarzy ✅ ✅
Wykrywanie siatki twarzy ✅
Wykrywanie pozycji ✅
Segmentacja selfie ✅
Skanowanie kodów kreskowych ✅ ✅
Oznaczanie obrazów ✅ ✅
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ę Zapisany w pamięci przeznaczonej dla aplikacji po zainstalowaniu Zapisano w pamięci przeznaczonej dla aplikacji po pobraniu modelu
Jak rozmiar modelu wpływa na rozmiar aplikacji? Nie wpływa na rozmiar aplikacji Bezpośredni wpływ na rozmiar aplikacji Nie wpływa na rozmiar aplikacji, ale zwiększa miejsce na dane aplikacji
Kiedy modele są aktualizowane? automatycznie aktualizowane po wydaniu nowszej wersji. Aby zaktualizować model, musisz zaktualizować aplikację Aby zaktualizować model, musisz zaktualizować aplikację
Kiedy są pobierane modele? Modele muszą zostać pobrane przed użyciem Wszystkie modele i funkcje są uwzględnione w aplikacji w momencie jej instalacji, więc można ich używać od razu. Pobraniami, aktualizacjami i usunięciami modeli należy zarządzać ręcznie za pomocą interfejsu RemoteModelManager API.
Kiedy modele są usuwane z urządzenia? Usługi Google Play usuną model z pamięci tylko wtedy, gdy wszystkie aplikacje, które go używają, zostaną odinstalowane. Modele są usuwane z magazynu specyficznego dla aplikacji po odinstalowaniu aplikacji. Pobrane modele są usuwane z pamięci aplikacji. podczas odinstalowania aplikacji.

Jak wybrać między usługami w pakiecie i bez pakietu

Jeśli interfejs API obsługuje zarówno opcje instalacji z dodatkami, jak i bez nich:

  • Skorzystaj z opcji pakietu, jeśli priorytetowo traktujesz:

    • pełna funkcjonalność funkcji od razu po zainstalowaniu aplikacji;
    • Funkcja bez połączenia z internetem po zainstalowaniu aplikacji

  • Skorzystaj z opcji niespakowanej, jeśli priorytetowo traktujesz:

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

Jak pobierać modele

Korzystając z opcji niespakowanego modelu, możesz określić sposób pobierania modeli na urządzenie:

  • Możesz włączyć pobieranie modelu podczas instalacji, dodając deklarację do: do pliku AndroidManifest.xml aplikacji. Poniżej znajdziesz fragment kodu, który pokazuje, jak skonfigurować aplikację, aby automatycznie pobierała model skanowania kodów kreskowych 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.3.0' // The latest version number of the API
}

  2. Utwórz ponownie 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ć. 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 ta opcja jest dostępna tylko w przypadku cyfrowego rozpoznawania pisma odręcznego, tłumaczenia i wyodrębniania informacji o podmiotach.