Introducción a Jetpack Media3

Jetpack Media3 es la nueva casa de las bibliotecas de contenido multimedia que permiten que las apps para Android muestren experiencias visuales y de audio enriquecidas. Media3 ofrece una arquitectura simple con personalización, confiabilidad y optimizaciones potentes basadas en las capacidades del dispositivo para abstraer la complejidad que conlleva la fragmentación.

En este documento, se presenta una introducción a las APIs clave para implementar casos de uso de reproducción y edición con Media3.

Componentes de reproducción

Media3 ofrece varios componentes clave para casos de uso de reproducción. Las clases que componen estos componentes te resultarán familiares si trabajaste con bibliotecas de medios anteriores de Android.

En el siguiente diagrama, se muestra cómo se combinan estos componentes en una app típica.

Los diferentes componentes de una app de medios que usa Media3 se conectan de varias maneras sencillas gracias a que comparten interfaces y clases.
Figura 1: Componentes de la app de música

El reproductor multimedia

Un reproductor multimedia es un componente de tu app que permite la reproducción de archivos multimedia. En Media3, encontrarás lo siguiente:

Clase Descripción Nota de implementación
Player Player es una interfaz que define capacidades tradicionales de alto nivel para un reproductor de medios, como la capacidad de reproducir, pausar y buscar. En Media3, la interfaz Player es una API común que implementan o usan varios componentes, incluidos MediaSession y MediaController, por ejemplo.
ExoPlayer ExoPlayer es la implementación predeterminada de la interfaz Player en Media3.

Obtén más información sobre Media3 ExoPlayer

La sesión multimedia

Una sesión multimedia proporciona una forma universal de interactuar con un reproductor multimedia. Esto permite que una app anuncie la reproducción de contenido multimedia a fuentes externas y reciba solicitudes de control de reproducción de fuentes externas. En Media3, encontrarás lo siguiente:

Clase Descripción Nota de implementación
MediaSession Las sesiones multimedia permiten que tu app interactúe con un reproductor de audio o video. Anuncian la reproducción de contenido multimedia de forma externa y reciben comandos de reproducción de fuentes externas. En Media3, un MediaSession necesita un Player para ejecutar comandos y obtener el estado actual.
MediaSessionService El MediaSessionService contiene una sesión multimedia y su reproductor asociado en un servicio independiente del Activity principal de tu app para facilitar la reproducción en segundo plano.
MediaController Por lo general, la clase MediaController se usa para enviar comandos desde fuera de tu app, por ejemplo, desde otras apps o el propio sistema. Los comandos se envían al Player subyacente del MediaSession asociado. La clase MediaController implementa la interfaz Player, pero, cuando se llama a un método, MediaController envía el comando al MediaSession conectado. Las apps cliente, como Asistente de Google, pueden usar MediaController para controlar la reproducción en una sesión conectada.
MediaLibraryService Un MediaLibraryService es similar a un MediaSessionService, excepto que incluye APIs adicionales para que puedas entregar tu biblioteca de contenido a las apps cliente.
MediaBrowser La clase MediaBrowser permite al usuario navegar por la biblioteca de contenido de una app de música y seleccionar qué elementos reproducir. La clase MediaBrowser implementa las interfaces MediaController y Player. Al igual que MediaController, las apps cliente, como Android Auto, suelen implementar MediaBrowser.

Más información sobre Media3 MediaSession

Los componentes de la IU

Media3 proporciona componentes de IU predeterminados para ver videos y controlar la reproducción.

Clase Descripción Nota de implementación
PlayerView Un View predeterminado para mostrar los controles de video y reproducción. Se conecta a ExoPlayer, MediaController o cualquier otro Player personalizado.
PlayerSurface Un elemento componible que representa un dibujo dedicado Surface para mostrar video. Se conecta a cualquier Player, pero no contiene controles de reproducción. Solo se usa para renderizar fotogramas y se puede cambiar de tamaño según varios tipos de ContentScale. Este y muchos otros elementos componibles se pueden encontrar en las utilidades de la IU de Compose.

Más información sobre la IU de Media3

Cómo editar componentes

Media3 incluye las APIs de Transformer para casos de uso de edición de medios, incluidos los siguientes:

  • Procesamiento de audio y video, como agregar filtros y efectos
  • Cómo controlar formatos especiales, como videos en HDR y videos en cámara lenta
  • Composición, como la combinación de varios archivos de entrada
  • Cómo exportar el resultado final a un archivo
Clase Descripción Nota de implementación
Transformer Usa la clase Transformer para iniciar y detener transformaciones, y para verificar las actualizaciones de progreso en una transformación en ejecución.
Effects Un objeto Effects es una colección de efectos de audio y video para aplicar a un elemento multimedia. Puedes usar ExoPlayer para obtener una vista previa de los efectos agregados a un elemento multimedia antes de iniciar el proceso de exportación.
EditedMediaItem Un EditedMediaItem representa un elemento multimedia que se procesará y las ediciones que se le aplicarán.

Más información sobre Media3 Transformer

Video introductorio

Mira el siguiente video para obtener una introducción a Media3 de los ingenieros que lo crearon.