Toutes les fonctionnalités de ML Kit utilisent des modèles de machine learning entraînés par Google (appelés modèles de base) par défaut. Ce guide ne s'applique qu'aux modèles de base. Cliquez ici pour obtenir des conseils sur les modèles personnalisés.
Les modèles des API ML Kit peuvent être installés de trois manières différentes:
- Sans catégorie:les modèles sont téléchargés et gérés via les services Google Play.
- Bundle:les modèles sont associés de manière statique à votre application au moment de la compilation.
- Téléchargement dynamique:les modèles sont téléchargés à la demande.
Chemins d'installation compatibles avec chaque API
Le tableau ci-dessous indique les chemins d'installation de modèles compatibles avec chaque fonctionnalité de ML Kit:
Sans catégorie | Pack | Téléchargement dynamique | |
Reconnaissance de texte v2 | ✅ | ✅ | |
Détection de visages | ✅ | ✅ | |
Détection des grilles faciales | ✅ | ||
Détection des doses | ✅ | ||
Segmentation des selfies | ✅ | ||
Lecture de codes-barres | ✅ | ✅ | |
Étiquetage d'images | ✅ | ✅ | |
Détection d'objets et suivi | ✅ | ||
Reconnaissance de la saisie manuscrite numérique | ✅ | ||
Scanner de documents | ✅ | ||
Segmentation par sujet | ✅ | ||
Lecteur de code Google | ✅ | ||
Identification de la langue | ✅ | ✅ | |
Traduction | ✅ | ||
Réponse suggérée | ✅ | ✅ | |
Extraction d'entités | ✅ |
Des guides spécifiques à l'API indiquent les options d'installation disponibles pour l'API donnée.
Principales différences entre les options d'installation
Sans catégorie | Pack | Téléchargement dynamique | |
Où les modèles sont-ils stockés ? | Réside dans les services Google Play et n'est pas comptabilisé dans l'espace de stockage utilisé par cette application | Enregistré dans un espace de stockage spécifique à l'application après l'installation | Enregistré dans un espace de stockage spécifique à l'application après le téléchargement du modèle |
Quel est l'impact de la taille du modèle sur la taille de l'application ? | Ne contribue pas à la taille de l'application | Contribue directement à la taille de l'application | Ne contribue pas à la taille de l'application, mais augmente l'espace de stockage spécifique à l'application |
Quand les modèles sont-ils mis à jour ? | Mise à jour automatique lorsqu'une version plus récente est disponible | Vous devez mettre à jour l'application pour mettre à jour le modèle | Vous devez mettre à jour l'application pour mettre à jour le modèle |
Quand les modèles sont-ils téléchargés ? | Les modèles doivent être téléchargés avant utilisation | Tous les modèles et toutes les fonctionnalités sont inclus lors de l'installation de l'application et sont donc utilisables immédiatement. | Les téléchargements, mises à jour et suppressions de modèles doivent être gérés manuellement à l'aide de l'API RemoteModelManager. |
Quand les modèles sont-ils retirés de l'appareil ? | Les services Google Play ne supprimeront le modèle de l'espace de stockage que si toutes les applications qui en dépendent sont désinstallées. | Les modèles sont supprimés du stockage propre à l'appli lorsque celle-ci est désinstallée | Les modèles téléchargés sont supprimés du stockage propre à l'appli lorsque celle-ci est désinstallée |
Choisir entre les groupes avec ou sans groupe
Si une API est compatible avec les options d'installation groupée et dégroupée:
Utilisez l'option d'offre groupée si vous privilégiez les éléments suivants:
- Intégrer la fonctionnalité immédiatement après l'installation de l'application
- Fonctionnalité sans connexion réseau après l'installation de l'application
Utilisez l'option sans catégorie si vous privilégiez:
- Taille des applications réduite
- Mises à jour automatiques des modèles par les services Google Play
Télécharger des modèles
Lorsque vous utilisez l'option de modèle dégroupé, vous pouvez spécifier le mode de téléchargement des modèles sur l'appareil:
Vous pouvez activer les téléchargements de modèles au moment de l'installation en ajoutant une déclaration au fichier
AndroidManifest.xml
de votre application. Par exemple, l'extrait de code ci-dessous montre comment configurer votre application pour télécharger automatiquement le modèle Barcode Scanning une fois votre application installée depuis le Play Store:<application ...> ... <meta-data android:name="com.google.mlkit.vision.DEPENDENCIES" android:value="barcode" > <!-- To use multiple models: android:value="barcode,model2,model3" --> </application>
Vous pouvez demander un téléchargement explicite via l'API ModuleInstallClient des services Google Play.
Si vous n'activez pas les téléchargements de modèles au moment de l'installation ou si vous ne demandez pas de téléchargement explicite, le modèle sera téléchargé la première fois que vous exécuterez la fonctionnalité. Les requêtes d'inférence échouent tant que le téléchargement n'est pas terminé.
Mettre à jour des modèles
Pour mettre à jour vos modèles lorsque vous utilisez le modèle groupé ou l'option de modèles téléchargés dynamiquement, procédez comme suit:
Mettez à jour le fichier Gradle de votre application pour utiliser la dernière bibliothèque cliente des fonctionnalités ML Kit.
dependencies { implementation 'com.google.mlkit:barcode-scanning: 17.2.0' // The latest version number of the API }
Recompilez votre application.
Pourquoi certaines API proposent des modèles téléchargés dynamiquement
Certaines API ML Kit proposent trop d'options de modèles à regrouper. Par exemple, la reconnaissance d'encre numérique est compatible avec plus de 300 langues, et il n'est pas toujours nécessaire d'inclure toutes les langues dans la fonctionnalité lors de l'installation. À cette fin, nous proposons la troisième option d'installation, qui permet de télécharger les modèles à la demande après l'installation. Actuellement, seules les fonctionnalités de reconnaissance d'encre numérique, de traduction et d'extraction d'entités disposent de cette option.