Guía de configuración para Android

En esta página, se muestra cómo configurar tu entorno de desarrollo para usar MediaPipe Tareas en tus aplicaciones para Android.

Dispositivos y plataformas compatibles

Para crear aplicaciones para Android con MediaPipe Tasks, el proyecto de del entorno de prueba requiere lo siguiente:

  • Android Studio con una una versión recomendada de al menos 2021.1.1 (Bumblebee) o alguna otra o IDE.
  • SDK de Android versión 24 o posterior
  • Dispositivo Android con al menos la versión de SDK mínima. Un emulador de Android es posible que no funcione en todas las tareas.

Configuración del entorno de desarrollador

Antes de ejecutar una tarea de MediaPipe en una aplicación para Android, debes tener una app existente o crea un nuevo proyecto de Android Studio en tu máquina local. MediaPipe se ajusta a los datos capa de tu app, que contiene los datos de la aplicación y la lógica empresarial. Para obtener más información Arquitectura de las apps para Android; consulta la Guía de uso de las apps arquitectura.

Configuración de dispositivos Android

Debes habilitar las Opciones para desarrolladores y la depuración por USB en un dispositivo Android físico antes de usarlo para probar tu aplicación. Si deseas obtener instrucciones para configurar tu dispositivo con Opciones para desarrolladores, consulta Cómo configurar el desarrollador de la aplicación.

Para las tareas que no requieren una cámara o un micrófono del dispositivo, puedes usar un Es un emulador de dispositivos Android en lugar de un dispositivo Android físico. Para obtener instrucciones para configurar un Android Emulator, consulta Cómo ejecutar apps en la app Emulador:

Ejemplo de configuración del código

El MediaPipe Repositorio de ejemplos contiene ejemplos de aplicaciones para Android para cada tarea de MediaPipe. Puedes crear un del código de ejemplo, compilar el proyecto y ejecutarlo.

Para importar y compilar el proyecto de código de ejemplo, haz lo siguiente:

  1. Inicia Android Studio.
  2. Desde Android Studio, selecciona File > Nuevo > Importa el proyecto.
  3. Navega al directorio de código de ejemplo que contiene el archivo build.gradle. y seleccionaré ese directorio, por ejemplo: .../mediapipe/examples/text_classification/android/build.gradle
  4. Si Android Studio solicita una sincronización de Gradle, selecciona OK.
  5. Asegúrate de que tu dispositivo Android esté conectado a tu computadora y al desarrollador esté habilitado. Haz clic en la flecha verde Run.

Si seleccionas el directorio correcto, Android Studio creará un nuevo proyecto y lo construye. Este proceso puede tardar unos minutos, según la velocidad de tu y si usaste Android Studio para otros proyectos. Cuando se crea se completa, Android Studio muestra un mensaje BUILD SUCCESSFUL en el Panel de estado Build Output.

Para ejecutar el proyecto, haz lo siguiente:

  1. En Android Studio, selecciona Run > Run...
  2. Selecciona un dispositivo Android conectado (o emulador) para probar la app.

Dependencias de las tareas de MediaPipe

MediaPipe Tasks proporciona tres bibliotecas previamente compiladas para visión, texto y audio. El El archivo de modelo .tflite debe estar ubicado en el directorio de recursos de Android. módulo que usa el modelo. Según la tarea de MediaPipe que use la app, agrega la biblioteca de visión, texto o audio a la lista de dependencias dentro del build.gradle.

Tareas de IA generativa

Las bibliotecas de IA generativa de MediaPipe Tasks contienen tareas que controlan imágenes o la generación de texto. Para importar las bibliotecas de IA generativa de MediaPipe Tasks Android Studio, agrega las dependencias a tu archivo build.gradle.

Generador de imágenes

La tarea Generador de imágenes MediaPipe se encuentra en tasks-vision-image-generator. Agrega la dependencia a tu Archivo build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-vision-image-generator:latest.release'
}

API de inferencia de LLM

La tarea de inferencia de MediaPipe LLM se encuentra en tasks-genai biblioteca. Agrega la dependencia a tu archivo build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-genai:latest.release'
}

Tareas de visión

La biblioteca de visión de MediaPipe Tasks contiene tareas que controlan imágenes o videos de datos. Para importar la biblioteca de visión de MediaPipe Tasks en Android Studio, agrega el las siguientes dependencias a tu archivo build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-vision:latest.release'
}

Tareas de texto

La biblioteca de texto de MediaPipe Tasks contiene tareas que manejan datos de idiomas en formato de texto. Para importar la biblioteca de texto MediaPipe Tasks en Android Studio, agrega las siguientes dependencias a tu archivo build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-text:latest.release'
}

Tareas de audio

La biblioteca de audio de MediaPipe Tasks contiene tareas que controlan entradas de sonido. Para importa la biblioteca de audio MediaPipe Tasks en Android Studio, agrega lo siguiente dependencias a tu archivo build.gradle:

dependencies {
    implementation 'com.google.mediapipe:tasks-audio:latest.release'
}

Configuración de BaseOptions

BaseOptions permite la configuración general de las APIs de MediaPipe Task.

Nombre de la opción Descripción Valores aceptados
modelAssetBuffer El archivo de recursos del modelo se incluye como un ByteBuffer directo o un MappedByteBuffer. ByteBuffer o MappedByteBuffer como una cadena
modelAssetPath La ruta de acceso del modelo a un archivo de recursos de modelo en la carpeta de recursos de aplicación para Android. Ruta de acceso al archivo como una cadena
modelAssetFileDescriptor El número entero del descriptor de archivos nativo de un archivo de elementos del modelo. Número entero que especifica el descriptor de archivo
Delegate Permite la aceleración de hardware mediante un delegado de dispositivo para ejecutar la canalización de MediaPipe. Valor predeterminado: CPU. [CPU,
GPU]

Aceleración de hardware

MediaPipe Tasks admite el uso de unidades de procesamiento gráfico (GPU) para ejecutar modelos de aprendizaje automático. En los dispositivos Android, puedes habilitar el uso de Ejecución acelerada por GPU de tus modelos a través de un delegado Los delegados actúan como controladores de hardware para MediaPipe, que te permiten ejecutar tus modelos en GPU en lugar de los estándar.

Configura el delegado de GPU en las opciones de tarea a través de BaseOptions:

BaseOptions baseOptions = BaseOptions.builder().useGpu().build();

Soluciona problemas

Para obtener ayuda con preguntas técnicas relacionadas con MediaPipe, visita la discusión group o Stack Menú ampliado para obtener asistencia de la comunidad. Para informar errores o solicitar funciones, informa un problema en GitHub.

Para obtener ayuda con la configuración de tu entorno de desarrollo de Android, visita la página documentación para desarrolladores.