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:
- Niegrupowane: modele są pobierane i zarządzane przez Usługi Google Play.
- W pakiecie: modele są statycznie połączone z aplikacją w momencie kompilacji.
- 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:
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 }
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