Fuentes de medios

En ExoPlayer, cada fragmento de contenido multimedia se representa con un objeto MediaItem. Sin embargo, internamente, el reproductor necesita instancias de MediaSource para reproducir el contenido. El reproductor los crea a partir de elementos multimedia con un MediaSource.Factory.

De forma predeterminada, el reproductor usa un DefaultMediaSourceFactory, que puede crear instancias de las siguientes implementaciones de MediaSource de contenido:

DefaultMediaSourceFactory también puede crear fuentes de medios más complejas según las propiedades de los elementos multimedia correspondientes. Esto se describe con más detalle en la página de elementos multimedia.

En el caso de las apps que necesitan configuraciones de fuentes de medios que no son compatibles con la configuración predeterminada del reproductor, existen varias opciones de personalización.

Cómo personalizar la creación de fuentes de medios

Cuando se compila el reproductor, se puede insertar un MediaSource.Factory. Por ejemplo, si una app quiere insertar anuncios y usar un CacheDataSource.Factory para admitir el almacenamiento en caché, se puede configurar una instancia de DefaultMediaSourceFactory para que coincida con estos requisitos y se pueda insertar durante la construcción del reproductor:

Kotlin

val mediaSourceFactory: MediaSource.Factory =
  DefaultMediaSourceFactory(context)
    .setDataSourceFactory(cacheDataSourceFactory)
    .setLocalAdInsertionComponents(adsLoaderProvider, playerView)
val player = ExoPlayer.Builder(context).setMediaSourceFactory(mediaSourceFactory).build()
MediaSources.kt

Java

MediaSource.Factory mediaSourceFactory =
    new DefaultMediaSourceFactory(context)
        .setDataSourceFactory(cacheDataSourceFactory)
        .setLocalAdInsertionComponents(adsLoaderProvider, /* adViewProvider= */ playerView);
ExoPlayer player =
    new ExoPlayer.Builder(context).setMediaSourceFactory(mediaSourceFactory).build();
MediaSources.java

En el JavaDoc de DefaultMediaSourceFactory, se describen las opciones disponibles con más detalle.

También es posible insertar una implementación de MediaSource.Factory personalizada, por ejemplo, para admitir la creación de un tipo de fuente de medios personalizada. Se llamará al createMediaSource(MediaItem) de la fábrica para crear una fuente de medios para cada elemento multimedia que se agregue a la playlist.

API de playlist basada en la fuente de contenido multimedia

La interfaz ExoPlayer define métodos de playlist adicionales que aceptan fuentes de contenido multimedia en lugar de elementos multimedia. Esto permite omitir el MediaSource.Factory interno del reproductor y pasar instancias de fuentes de medios directamente al reproductor:

Kotlin

// Set a list of media sources as initial playlist.
exoPlayer.setMediaSources(listOfMediaSources)
// Add a single media source.
exoPlayer.addMediaSource(anotherMediaSource)

// Can be combined with the media item API.
exoPlayer.addMediaItem(/* index= */ 3, MediaItem.fromUri(videoUri))

exoPlayer.prepare()
exoPlayer.play()
MediaSources.kt

Java

// Set a list of media sources as initial playlist.
exoPlayer.setMediaSources(listOfMediaSources);
// Add a single media source.
exoPlayer.addMediaSource(anotherMediaSource);

// Can be combined with the media item API.
exoPlayer.addMediaItem(/* index= */ 3, MediaItem.fromUri(videoUri));

exoPlayer.prepare();
exoPlayer.play();
MediaSources.java

Composición avanzada de fuentes de medios

ExoPlayer proporciona varias implementaciones de MediaSource para modificar y componer otras instancias de MediaSource. Son más útiles en los casos en que se deben combinar varias personalizaciones y ninguno de los métodos de configuración más sencillos es suficiente.

  • ClippingMediaSource: Permite recortar contenido multimedia en un intervalo de marcas de tiempo especificado. Si esta es la única modificación, es preferible usar MediaItem.ClippingConfiguration en su lugar.
  • FilteringMediaSource: Filtra las pistas disponibles según los tipos especificados, por ejemplo, solo expone la pista de video de un archivo que contiene audio y video. Si esta es la única modificación, es preferible usar parámetros de selección de pistas.
  • MergingMediaSource: Combina varias fuentes de medios para reproducirlas en paralelo. En casi todos los casos, es recomendable llamar al constructor con adjustPeriodTimeOffsets y clipDurations establecidos en verdadero para garantizar que todas las fuentes comiencen y finalicen al mismo tiempo. Si esta modificación se realiza para agregar subtítulos cargados de forma lateral, es preferible usar MediaItem.SubtitleConfiguration en su lugar.
  • ConcatenatingMediaSource2: Combina varias fuentes de medios para reproducirlas de forma consecutiva. La estructura de contenido multimedia visible para el usuario expone un solo Timeline.Window, lo que significa que se ve como un solo elemento. Si esta modificación se realiza para reproducir varios elementos que no deberían parecer uno solo, es preferible usar los métodos de la API de playlist, como Player.addMediaItem.
  • SilenceMediaSource: Genera silencio durante un período especificado, lo que resulta útil para llenar brechas.
  • AdsMediaSource: Extiende una fuente de medios con capacidades de inserción de anuncios del cliente. Consulta la guía de inserción de anuncios para obtener más detalles.
  • ServerSideAdInsertionMediaSource: Extiende una fuente de medios con capacidades de inserción de anuncios del servidor. Consulta la guía de inserción de anuncios para obtener más detalles.