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

De forma predeterminada, todas las funciones de ML Kit utilizan modelos de aprendizaje automático entrenados por Google (conocidos como modelos base). Esta guía solo se aplica a los modelos básicos. Consulta aquí para obtener orientación sobre los modelos personalizados.

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

  1. Desvinculado: Los modelos se descargan y administran a través de los Servicios de Google Play.
  2. Integrados: Los modelos se vinculan de forma estática a tu app en 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 del modelo que admite cada función de ML Kit:

Sin paquete Incluido Descarga dinámica
Reconocimiento de texto v2 ✅ ✅
Detección de rostro ✅ ✅
Detección de malla facial ✅
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 sujetos ✅
Escáner de códigos de Google ✅
Identificación de idiomas ✅ ✅
Traducción ✅
Respuesta inteligente ✅ ✅
Extracción de entidades ✅

Las guías específicas de la API muestran qué opciones de instalación están disponibles para la API determinada.

Diferencias clave entre las opciones de instalación

Sin paquete Incluido Descarga dinámica
¿Dónde se almacenan los modelos? Reside en los Servicios de Google Play y no se incluye en el almacenamiento utilizado por 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 descargar el modelo.
¿Cómo afecta el tamaño del modelo al tamaño de la app? No contribuye al 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 se deben descargar antes de usarlos Todos los modelos y funciones se incluyen cuando se instala la app, por lo que se pueden usar de inmediato Las descargas, actualizaciones y eliminaciones de modelos se deben administrar 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 de él. Los modelos se quitan del almacenamiento específico de la app cuando se desinstala la app. Los modelos descargados se quitan del almacenamiento específico de la app cuando se desinstala la app.

Cómo elegir entre la opción con paquete y sin paquete

Si una API admite las opciones de instalación agrupada y no agrupada, haz lo siguiente:

  • Usa la opción agrupada si priorizas lo siguiente:

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

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

    • Apps de menor tamaño
    • Actualizaciones automáticas del modelo por parte de los Servicios de Google Play

Cómo descargar modelos

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

  • Para habilitar las descargas de modelos durante la instalación, agrega una declaración al archivo AndroidManifest.xml de tu app. Por ejemplo, el siguiente fragmento de código muestra cómo configurar tu app para que descargue automáticamente el modelo de Barcode Scanning después de que se instale 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 la 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 o no solicitas la descarga explícita, el modelo se descargará la primera vez que ejecutes la función. Hasta que se complete la descarga, fallarán las solicitudes de inferencia.

Cómo actualizar modelos

Para actualizar tus modelos cuando usas la opción de modelos incluidos o modelos descargados de forma dinámica, haz lo siguiente:

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

    dependencies {
  implementation 'com.google.mlkit:barcode-scanning: 17.3.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 APIs de ML Kit tienen demasiadas opciones de modelos para incluir. Por ejemplo, el reconocimiento de escritura a mano admite más de 300 idiomas, y no siempre es necesario incluir todos los idiomas en 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 Reconocimiento de escritura a mano, Traducción y Extracción de entidades tienen esta opción.