Ścieżki instalacji modelu ML Kit na Androidzie

Wszystkie funkcje ML Kit domyślnie korzystają z modeli uczenia maszynowego wytrenowanych przez Google (tzw. modeli bazowych). Ten przewodnik dotyczy tylko podstawowych modeli. Więcej informacji o modelach niestandardowych

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

1. W ramach pakietu: modele są pobierane i zarządzane za pomocą Usług Google Play.
2. W pakiecie: modele są statycznie powiązane 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	Pobrany dynamicznie
Rozpoznawanie tekstu w wersji 2	✅	✅
Wykrywanie twarzy	✅	✅
Wykrywanie siatki twarzy		✅
Wykrywanie pozy		✅
Podział na segmenty na podstawie selfie		✅
Skanowanie kodów kreskowych	✅	✅
Etykietowanie obrazów	✅	✅
wykrywanie i śledzenie obiektów,		✅
Rozpoznawanie atramentu cyfrowego			✅
Skaner dokumentów	✅
Podział na tematy	✅
skaner kodu Google,	✅
Identyfikacja języka	✅	✅
Tłumaczenie			✅
Inteligentna odpowiedź	✅	✅
Ekstrakcja encji			✅

W przewodnikach dotyczących poszczególnych interfejsów API znajdziesz informacje o dostępnych opcjach instalacji.

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

	Nieskładane	W pakiecie	Pobrany dynamicznie
Gdzie są przechowywane modele?	znajduje się w Usługach Google Play i nie jest wliczana do miejsca na dane używanego przez tę aplikację;	Zapisywanie w pamięci przeznaczonej dla aplikacji po zainstalowaniu	zapisany w miejscu na dane aplikacji po pobraniu modelu;
Jak rozmiar modelu wpływa na rozmiar aplikacji?	nie zwiększa rozmiaru aplikacji;	Bezpośredni wpływ na rozmiar aplikacji	Nie zwiększa rozmiaru aplikacji, ale zwiększa miejsce na dane aplikacji
Kiedy są aktualizowane modele?	automatycznie aktualizowane po wydaniu nowszej wersji.	Aby zaktualizować model, musisz zaktualizować aplikację	Aby zaktualizować model, musisz zaktualizować aplikację
Kiedy pobierane są modele?	Modele muszą zostać pobrane przed użyciem	Wszystkie modele i funkcje są dostępne po zainstalowaniu aplikacji, 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.	Po odinstalowaniu aplikacji pobrane modele są usuwane z magazynu danych aplikacji.

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

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

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

  • Użytkownicy mogą korzystać z funkcji od razu po zainstalowaniu aplikacji.
  • Funkcje 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:

• Aby włączyć pobieranie modelu w czasie instalacji, dodaj deklarację do pliku AndroidManifest.xml aplikacji. Na przykład poniższy fragment kodu pokazuje, jak skonfigurować aplikację, aby pobieranie modelu skanowania kodów kreskowych odbywało się automatycznie 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>
  

• Możesz poprosić o pobieranie z wyrażeniem zgody za pomocą interfejsu ModuleInstallClient API w usługach Google Play.

• Jeśli nie włączysz pobierania modelu w czasie instalacji ani nie poprosisz o pobieranie modelu, model zostanie pobrany przy pierwszym uruchomieniu funkcji. Dopóki pobieranie nie zostanie ukończone, prośby o wykonywanie wniosków będą kończyć się niepowodzeniem.

Jak aktualizować modele

Aby zaktualizować modele, gdy używasz modelu w pakiecie lub opcji pobierania modeli dynamicznie:

1. Zaktualizuj plik gradle aplikacji, aby korzystać z najnowszej biblioteki klienta funkcji ML Kit.

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

2. Zbuduj ponownie aplikację.

Dlaczego niektóre interfejsy API umożliwiają pobieranie modeli dynamicznie

Niektóre interfejsy ML Kit mają zbyt wiele opcji modeli, aby można je było umieścić w pakiecie. Na przykład funkcja rozpoznawania pisma odręcznego obsługuje ponad 300 języków, ale nie zawsze trzeba uwzględnić wszystkie z nich podczas instalacji. W tym celu 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.