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:
- Inicia Android Studio.
- Desde Android Studio, selecciona File > Nuevo > Importa el proyecto.
- 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 - Si Android Studio solicita una sincronización de Gradle, selecciona OK.
- 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:
- En Android Studio, selecciona Run > Run...
- 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.