Chemins d'installation des modèles ML Kit sur Android

Toutes les fonctionnalités de ML Kit utilisent par défaut des modèles de machine learning entraînés par Google (appelés modèles de base). 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 dans les API ML Kit peuvent être installés de trois manières différentes:

  1. Sans bundle:les modèles sont téléchargés et gérés via les services Google Play.
  2. Ensemble:les modèles sont associés de manière statique à votre application au moment de la compilation.
  3. Téléchargement dynamique:les modèles sont téléchargés à la demande.

Chemins d'installation compatibles pour chaque API

Le tableau ci-dessous indique les chemins d'installation des modèles compatibles avec chaque fonctionnalité de ML Kit:

Sans catégorie Lotés Téléchargement dynamique
Reconnaissance de texte (version 2) ✅ ✅
Détection de visages ✅ ✅
Détection des grilles faciales ✅
Détection de la pose ✅
Segmentation des selfies ✅
Lecture de codes-barres ✅ ✅
Étiquetage des 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 ✅

Les guides spécifiques aux API indiquent les options d'installation disponibles pour l'API donnée.

Principales différences entre les options d'installation

Sans catégorie Lots Téléchargement dynamique
Où sont stockés les modèles ? Réside dans les services Google Play et n'est pas comptabilisé dans l'espace de stockage utilisé par cette appli Enregistrées dans l'espace de stockage spécifique à l'application après l'installation Enregistré dans l'espace de stockage spécifique à l'application après le téléchargement du modèle
Comment la taille du modèle affecte-t-elle 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 ? Automatiquement mis à jour lorsqu'une nouvelle version 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 ? Vous devez télécharger les modèles avant de les utiliser Tous les modèles et toutes les fonctionnalités sont inclus lors de l'installation de l'appli, donc sont 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 du stockage que si toutes les applications qui en dépendent sont désinstallées Les modèles sont supprimés de l'espace de stockage spécifique à l'application lorsque celle-ci est désinstallée. Les modèles téléchargés sont supprimés de l'espace de stockage spécifique à l'application lorsque celle-ci est désinstallée.

Choisir entre une offre groupée et une offre dégroupée

Si une API est compatible avec les options d'installation avec et sans bundle:

  • Utilisez l'option groupée si vous donnez la priorité aux éléments suivants:

    • Activer 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 groupe si vous donnez la priorité aux éléments suivants:

    • 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 sans groupe, vous pouvez spécifier le mode de téléchargement des modèles sur l'appareil:

  • Vous pouvez activer le téléchargement du modèle 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 de lecture de codes-barres une fois votre application installée à partir du 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 ne demandez pas de téléchargement explicite, le modèle est téléchargé la première fois que vous exécutez la fonctionnalité. Tant que le téléchargement n'est pas terminé, les requêtes d'inférence échouent.

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:

  1. Mettez à jour le fichier Gradle de votre application pour utiliser la dernière bibliothèque cliente des fonctionnalités de ML Kit.

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

  2. Recompilez votre application.

Pourquoi certaines API proposent-elles des modèles téléchargés dynamiquement ?

Certaines API de ML Kit ont trop d'options de modèle à regrouper. Par exemple, la reconnaissance d'encre numérique accepte plus de 300 langues et il n'est pas toujours nécessaire d'inclure toutes les langues dans cette 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 la reconnaissance d'encre numérique, la traduction et l'extraction d'entités proposent cette option.