Introducción a Jetpack Media3

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

En este documento, se proporciona 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 los casos de uso de reproducción. Las clases que componen estos componentes te resultarán familiares si ya trabajaste con bibliotecas de contenido multimedia de Android anteriores.

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

Los diferentes componentes de una app multimedia que usa Media3 se conectan entre sí de varias maneras sencillas, ya que comparten interfaces y clases.
Figura 1: Componentes de la app multimedia

El reproductor multimedia

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

Clase Descripción Nota de implementación
Player Player es una interfaz que define las capacidades tradicionales de alto nivel para un reproductor multimedia, 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.

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 MediaSessionService contiene una sesión multimedia y su reproductor asociado en un servicio independiente de la Activity principal de tu app para facilitar la reproducción en segundo plano.
MediaController La clase MediaController se suele usar para enviar comandos desde fuera de tu app, por ejemplo, desde otras apps o el 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 enviado 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 que el usuario navegue por la biblioteca de contenido de una app multimedia y seleccione los elementos que quiere 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 MediaSession de Media3

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 elemento View predeterminado para mostrar los controles de video y reproducción Se conecta a ExoPlayer, MediaController o cualquier otro Player personalizado.
PlayerSurface Es un elemento componible que representa un Surface de dibujo dedicado 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

Edita componentes

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

  • Procesamiento de audio y video, como agregar filtros y efectos
  • Cómo controlar formatos especiales, como videos HDR y en cámara lenta
  • Composición, como combinar varios archivos de entrada
  • Exporta 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 que se aplican 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 este video para obtener una introducción a Media3 de los ingenieros que lo crearon: