Rutas de instalación del modelo del ML Kit en Android

Todas las funciones del ML Kit usan modelos de aprendizaje automático entrenados por Google (conocidos como modelos base) de forma predeterminada. Esta guía solo se aplica a los modelos base. Consulta esta página para obtener orientación sobre modelos personalizados.

Los modelos de las APIs del ML Kit se pueden instalar de una de estas tres maneras:

  1. Sin agrupar: Los modelos se descargan y administran a través de los Servicios de Google Play.
  2. Agrupados: Los modelos se vinculan de forma estática a tu app durante el tiempo de compilación.
  3. Descarga dinámica: Los modelos se descargan a pedido.

Rutas de instalación admitidas para cada API

En la siguiente tabla, se muestran las rutas de instalación de modelos que son compatibles con cada función del ML Kit:

Sin agrupar Agrupados Descarga dinámica
Reconocimiento de texto v2 ✅ ✅
Detección de rostro ✅ ✅
Detección de malla de rostros ✅
Detección de poses ✅
Segmentación de selfies ✅
Escaneo de códigos de barras ✅ ✅
Etiquetado de imágenes ✅ ✅
Detección y seguimiento de objetos ✅
Reconocimiento de la tinta digital ✅
Escáner de documentos ✅
Segmentación de tema ✅
Escáner de códigos de Google ✅
Identificación de idiomas ✅ ✅
Translation ✅
Respuesta inteligente ✅ ✅
Extracción de entidades ✅

En las guías específicas de la API, se muestra qué opciones de instalación están disponibles para la API determinada.

Diferencias clave entre las opciones de instalación

Sin agrupar Agrupados Descarga dinámica
¿Dónde se almacenan los modelos? Residen en los Servicios de Google Play y no se consideran en el almacenamiento que usa esta app. Se guarda en el almacenamiento específico de la app después de la instalación. Se guarda en el almacenamiento específico de la app después de la descarga del modelo.
¿Cómo afecta el tamaño del modelo al tamaño de la app? No influye en el tamaño de la app Contribuye directamente al tamaño de la app No contribuye al tamaño de la app, pero aumenta el almacenamiento específico de la app.
¿Cuándo se actualizan los modelos? Se actualiza automáticamente cuando se lanza una versión más reciente. Se debe actualizar la app para actualizar el modelo Se debe actualizar la app para actualizar el modelo
¿Cuándo se descargan los modelos? Los modelos deben descargarse antes de usarlos Todos los modelos y las funciones se incluyen cuando se instala la app, por lo que se pueden usar de inmediato. Las descargas, actualizaciones y eliminaciones de modelos deben administrarse de forma manual con la API de RemoteModelManager.
¿Cuándo se quitan los modelos del dispositivo? Los Servicios de Google Play solo quitarán el modelo del almacenamiento si se desinstalan todas las apps que dependen del modelo Los modelos se quitan del almacenamiento específico de la app cuando esta se desinstala Los modelos descargados se quitan del almacenamiento específico de la app cuando esta se desinstala

Cómo elegir entre paquetes y desagrupados

Si una API admite las opciones de instalación integradas y sin empaquetar:

  • Usa la opción de paquetes si priorizas lo siguiente:

    • Completa la funcionalidad de la función inmediatamente después de instalar la app
    • Funcionalidad de función sin conexión de red después de instalar la app

  • Usa la opción sin agrupar si priorizas lo siguiente:

    • Apps de menor tamaño
    • Actualizaciones automatizadas de modelos por parte de los Servicios de Google Play

Cómo descargar modelos

Cuando usas la opción de modelo sin empaquetar, puedes especificar cómo quieres que se descarguen los modelos en el dispositivo:

  • Para habilitar las descargas del modelo en el momento de la instalación, agrega una declaración al archivo AndroidManifest.xml de la app. Por ejemplo, en el siguiente fragmento de código, se muestra cómo configurar tu app para que descargue automáticamente el modelo de escaneo de códigos de barras después de instalar la app desde 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>

  • Puedes solicitar una descarga explícita a través de la API de ModuleInstallClient de los Servicios de Google Play.

  • Si no habilitas las descargas de modelos en el momento de la instalación ni solicitas una descarga explícita, el modelo se descargará la primera vez que ejecutes la función. Las solicitudes de inferencia fallarán hasta que se complete la descarga.

Cómo actualizar modelos

Para actualizar los modelos cuando usas el modelo empaquetado o la opción de modelos descargados de forma dinámica, haz lo siguiente:

  1. Actualiza el archivo de Gradle de tu app para usar la biblioteca cliente de funciones más reciente del ML Kit.

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

  2. Vuelve a compilar la app.

Por qué algunas APIs ofrecen modelos descargados de forma dinámica

Algunas API del ML Kit tienen demasiadas opciones de modelos para empaquetar. Por ejemplo, el reconocimiento de la tinta digital admite más de 300 idiomas y no siempre es necesario poner todos los idiomas dentro de la función durante la instalación. Para ello, proporcionamos la tercera opción de instalación, en la que los modelos se descargan a pedido después de la instalación. Actualmente, solo las opciones Reconocimiento de tinta digital, Translation y Extracción de entidades tienen esta opción.