Rutas de instalación de los modelos del Kit de AA en Android

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Todas las funciones del Kit de AA 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 aquí para obtener orientación sobre los modelos personalizados.

Los modelos en las API del Kit de AA se pueden instalar de tres maneras:

  1. Sin empaquetar: 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 con tu app durante la compilación.
  3. Descarga dinámica: Los modelos se descargan a pedido.

Rutas de instalación compatibles para cada API

En la siguiente tabla, se muestra qué rutas de instalación del modelo son compatibles con cada función del Kit de AA:

Sin empaquetar Agrupados en paquetes Descarga dinámica
Reconocimiento de texto ✅
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 tinta digital ✅
Escáner de código de Google ✅
Identificación de idiomas ✅ ✅
Translation ✅
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 fundamentales entre las opciones de instalación

Sin empaquetar Agrupados Descargada de forma dinámica
¿Dónde se almacenan los modelos? Reside en los Servicios de Google Play y no se cuenta para 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 contribuye al tamaño de la app Contribuye directamente al tamaño de la app Contribuye directamente al tamaño 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 aplicación para actualizar el modelo Se debe actualizar la aplicación 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 aplicación, por lo que se pueden utilizar 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 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 paquetes agrupados y desagrupados

Si una API admite las opciones de instalación agrupadas y desagrupadas:

  • Usa la opción agrupada si priorizas:

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

  • Usa la opción sin agrupar si le das prioridad:

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

Cómo descargar modelos

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

  • Puedes habilitar las descargas de modelos en el momento de la instalación si agregas una declaración al archivo AndroidManifest.xml de tu app. Por ejemplo, en el siguiente fragmento de código, se muestra cómo configurar la 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 del modelo 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 tus modelos cuando usas el modelo empaquetado o la opción de modelos descargados de forma dinámica, haz lo siguiente:

  1. Actualiza el archivo Gradle de tu app para usar la última biblioteca cliente de funciones del Kit de AA.

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

  2. Vuelve a compilar la app.

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

Algunas API del Kit de AA tienen demasiadas opciones de modelos para agruparlas. Por ejemplo, el reconocimiento digital de tinta admite más de 300 idiomas y no siempre es necesario colocar todos los idiomas dentro de la función durante la instalación. Con ese fin, 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 la opción Reconocimiento de tinta digital, Translation y Extracción de entidades tienen esta opción.