Aplicación de demostración de Transformer

La app de demostración de Transformer te permite probar las capacidades de la API y transformar tu propio contenido multimedia, lo que incluye convertir contenido multimedia entre formatos, cortar y aplicar efectos de video.

En esta página, se describe cómo obtener, compilar y ejecutar la app de demostración y cómo usarla para transformar tu propio contenido multimedia.

Obtén el código

Puedes encontrar el código fuente de la app de demostración principal en la carpeta demos/transformer del proyecto de GitHub. Si aún no lo has hecho, clona el proyecto en un directorio local:

git clone https://github.com/androidx/media.git

A continuación, abre el proyecto en Android Studio. Deberías ver lo siguiente en la vista Android Project (se expandieron las carpetas relevantes de la app de demostración):

El proyecto en Android Studio
El proyecto en Android Studio

Cómo compilar y ejecutar la demostración

Para compilar y ejecutar la app de demostración, selecciona y ejecuta la configuración demo-transformer en Android Studio. La app de demostración se instalará y ejecutará en un dispositivo conectado con Android. Si es posible, recomendamos usar un dispositivo físico porque, por lo general, la implementación de la pila de contenido multimedia de Android que realiza un emulador tiene diferentes capacidades y errores en comparación con un dispositivo real.

Actividad de configuración de la app de demostración
Actividad de configuración de la app de demostración

La app de demostración comienza con ConfigurationActivity, una actividad en la que puedes configurar el elemento multimedia de entrada y la transformación que deseas realizar. Los dos botones de la parte superior de la pantalla te permiten elegir un archivo de una lista de archivos multimedia predefinidos o elegir un archivo local. A continuación, la lista desplazable de opciones te permite configurar el formato de la salida y las transformaciones, y puedes seleccionar los efectos que deseas aplicar al medio. Cuando se presiona el último botón, se pasa a TransformerActivity, una actividad que muestra el progreso actual y una vista previa de los fotogramas a medida que pasan por Transformer. Una vez que se completa la transformación, los videos de entrada y salida se muestran juntos en dos instancias PlayerView de ExoPlayer.

Transforma tu propio contenido

La app de demostración admite la selección de contenido multimedia para la transformación con los botones de la parte superior de la pantalla de configuración. También puedes pasar una URL directamente en la línea de comandos:

adb shell am start -a androidx.media3.demo.transformer.action.VIEW \
    -d https://yourdomain.com/sample.mp4

Integración de MediaPipe

La app de demostración incluye un ejemplo de integración con MediaPipe. Deberás compilar la dependencia manualmente y, luego, seleccionar la variante de compilación withMediaPipe para habilitar la compilación de la app con el procesador de marcos de canal multimedia. Consulta el archivo README para obtener instrucciones completas. El selector de efectos en la actividad de configuración incluye un efecto de ejemplo basado en MediaPipe para probar esto.