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. Ver aquí para obtener orientación sobre los modelos personalizados.

Los modelos en 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. Paquetes: Los modelos se vinculan de forma estática a tu app durante el tiempo de compilación.
  3. Descargados de forma 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 los modelos que admite cada AA Función del kit:

Sin agrupar Paquetes Descargadas de forma 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 por tema ✅
Escáner de código de Google ✅
Identificación de idiomas ✅ ✅
Translation ✅
Respuesta inteligente ✅ ✅
Extracción de entidades ✅

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

Diferencias clave entre las opciones de instalación

Sin agrupar Paquetes Descargadas de forma dinámica
¿Dónde se almacenan los modelos? Reside en los Servicios de Google Play y no se incluye en el almacenamiento. usado por esta app Se guardan en el almacenamiento específico de la app. después de la instalación Se guardan 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 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 Es necesario actualizar la app para actualizar el modelo Es necesario 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 las funciones se incluyen cuando la app está instalada, por lo que se pueden usar de inmediato. Las descargas, actualizaciones y eliminaciones de modelos se deben administrar manualmente usando RemoteModelManager API
¿Cuándo se quitan los modelos del dispositivo? Los Servicios de Google Play solo quitarán el modelo del almacenamiento si todas las apps que dependen del modelo se desinstalarán Los modelos se quitan del almacenamiento específico de la app. Cuando se desinstala la aplicación Los modelos descargados se quitan del almacenamiento específico de la app Cuando se desinstala la aplicación

Cómo elegir entre agrupado y sin agrupar

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

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

    • Completar la funcionalidad de las funciones inmediatamente después de instalar la app
    • Funcionalidad de la 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 de los Servicios de Google Play

Cómo descargar modelos

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

  • Puedes habilitar las descargas de modelos en el momento de la instalación agregando una declaración al el archivo AndroidManifest.xml de tu app. Por ejemplo, el siguiente fragmento de código se muestra cómo configurar tu app para que descargue automáticamente el código de barras Analiza el modelo después de instalar tu 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 los Servicios de Google Play API de ModuleInstallClient.

  • Si no habilitas las descargas de modelos en el momento de la instalación ni solicitas descargar, 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 se usa el modelo empaquetado o el archivo descargado de forma dinámica de modelos de AA:

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

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

  2. Vuelve a compilar tu 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, Tinta digital reconocimiento admite más de 300 idiomas, y no es siempre es necesario colocar cada lenguaje en la función durante la instalación. Para ello, proporcionamos la tercera opción de instalación, en la que los modelos descargar a pedido después de la instalación. Actualmente, solo se puede usar la tinta digital reconocimiento de imágenes, Translation y Entidad de extracción tienen esta opción.