Ścieżki instalacji modelu ML Kit na Androidzie

Wszystkie funkcje ML Kit domyślnie korzystają z wytrenowanych przez Google modeli uczenia maszynowego (tzw. modeli podstawowych). Ten przewodnik dotyczy tylko modeli podstawowych. Tutaj znajdziesz wskazówki dotyczące modeli niestandardowych

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

1. Oddzielne: modele są pobierane i zarządzane za pomocą Usług Google Play.
2. Połączone: modele są statycznie połączone z aplikacją w momencie jej tworzenia.
3. Pobierane dynamicznie: modele są pobierane na żądanie.

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

W tabeli poniżej znajdziesz informacje o tym, które ścieżki instalacji modelu są obsługiwane przez poszczególne funkcje ML Kit:

	Niepołączone	W pakiecie	Pobierane dynamicznie
Rozpoznawanie tekstu w wersji 2	✅	✅
Wykrywanie twarzy	✅	✅
Wykrywanie siatki twarzy		✅
Wykrywanie pozycji		✅
Segmentacja selfie		✅
Skanowanie kodów kreskowych	✅	✅
Dodawanie etykiet do obrazów	✅	✅
Wykrywanie i śledzenie obiektów		✅
Rozpoznawanie pisma odręcznego			✅
Skaner dokumentów	✅
Segmentacja tematyczna	✅
Skaner kodów Google	✅
Identyfikacja języka	✅	✅
Tłumaczenie			✅
Inteligentna odpowiedź	✅	✅
Ekstrakcja encji			✅

Przewodniki dotyczące poszczególnych interfejsów API pokazują, które opcje instalacji są dostępne w przypadku danego interfejsu API.

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

	Niepołączone	W pakiecie	Pobierane 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ę.	Zapisywane w pamięci konkretnej aplikacji po instalacji	Zapisywane 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?	Automatycznie aktualizowana po wydaniu nowszej wersji	Aby zaktualizować model, musisz zaktualizować aplikację	Aby zaktualizować model, musisz zaktualizować aplikację
Kiedy modele są pobierane?	Modele muszą zostać pobrane przed użyciem	Wszystkie modele i funkcje są dostępne od razu po zainstalowaniu aplikacji.	Pobieranie, aktualizowanie i usuwanie modeli musi być zarządzane ręcznie za pomocą interfejsu RemoteModelManager.
Kiedy modele są usuwane z urządzenia?	Usługi Google Play usuną model z pamięci tylko wtedy, gdy wszystkie aplikacje, które od niego zależą, zostaną odinstalowane.	Modele są usuwane z pamięci aplikacji, gdy aplikacja jest odinstalowywana.	Pobrane modele są usuwane z pamięci aplikacji, gdy aplikacja jest odinstalowywana.

Jak wybrać między usługami łączonymi a niełączonymi

Jeśli interfejs API obsługuje zarówno opcję instalacji pakietowej, jak i niepakietowej:

• Skorzystaj z opcji pakietu, jeśli priorytetem jest dla Ciebie:

  • Pełna funkcjonalność od razu po zainstalowaniu aplikacji
  • Funkcje działające bez połączenia z siecią po zainstalowaniu aplikacji

• Wybierz opcję bez pakietu, jeśli priorytetem jest dla Ciebie:

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

Pobieranie modeli

Jeśli używasz opcji modelu bez pakietu, możesz określić, jak modele mają być pobierane na urządzenie:

• Aby włączyć pobieranie modeli w momencie instalacji, dodaj deklarację do pliku AndroidManifest.xml aplikacji. Na przykład poniższy fragment kodu pokazuje, jak skonfigurować aplikację, aby automatycznie pobierała model skanowania kodów kreskowych po zainstalowaniu jej 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 wyraźne pobranie za pomocą interfejsu ModuleInstallClient API w Usługach Google Play.

• Jeśli nie włączysz pobierania modelu w momencie instalacji lub nie poprosisz o wyraźne pobranie, model zostanie pobrany przy pierwszym uruchomieniu funkcji. Do czasu zakończenia pobierania żądania wnioskowania będą kończyć się niepowodzeniem.

Jak aktualizować modele

Aby zaktualizować modele, gdy używasz opcji dołączonego modelu lub modeli pobieranych dynamicznie:

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

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

2. Przebuduj aplikację.

Dlaczego niektóre interfejsy API oferują modele pobierane dynamicznie

Niektóre interfejsy API ML Kit mają zbyt wiele opcji modeli, aby można je było połączyć. Na przykład rozpoznawanie pisma odręcznego obsługuje ponad 300 języków i nie zawsze jest konieczne umieszczanie wszystkich języków w funkcji 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 rozpoznawania pisma odręcznego, tłumaczenia i wyodrębniania jednostek.