Fuentes de medios

En ExoPlayer, cada elemento multimedia está representado por un 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 multimedia más complejas según las propiedades de los elementos multimedia correspondientes. Esto se describe con más detalle en la página Elementos multimedia.

En las apps que necesitan configuraciones de fuente multimedia que no son compatibles con la configuración predeterminada del reproductor, hay varias opciones de personalización.

Cómo personalizar la creación de fuentes multimedia

Cuando se compila el reproductor, se puede insertar un MediaSource.Factory. Por ejemplo, si una app desea 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 inyecte 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()

Java

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

El JavaDoc DefaultMediaSourceFactory describe 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 multimedia personalizado. Se llamará a createMediaSource(MediaItem) de la fábrica para crear una fuente multimedia para cada elemento multimedia que se agregue a la playlist.

API de playlists basadas en fuentes multimedia

La interfaz ExoPlayer define métodos de playlist adicionales que aceptan fuentes multimedia en lugar de elementos multimedia. Esto permite omitir el MediaSource.Factory interno del reproductor y pasar instancias de fuentes de contenido multimedia 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()

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();

Composición avanzada de fuentes multimedia

ExoPlayer proporciona varias implementaciones de MediaSource para modificar y componer otras instancias de MediaSource. Estas opciones son más útiles en los casos en los que se deben combinar varias personalizaciones y ninguna de las rutas de configuración más simples es suficiente.

  • ClippingMediaSource: Permite recortar contenido multimedia en un rango de marca de tiempo especificado. Si esta es la única modificación, es preferible usar MediaItem.ClippingConfiguration en su lugar.
  • FilteringMediaSource: Filtra las pistas disponibles para 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 utilizar parámetros de selección de pista en su lugar.
  • MergingMediaSource: Combina varias fuentes multimedia para que se reproduzcan en paralelo. En casi todos los casos, es recomendable llamar al constructor con adjustPeriodTimeOffsets y clipDurations configurados como verdaderos para asegurarte de que todas las fuentes comiencen y terminen al mismo tiempo. Si se realiza esta modificación para agregar subtítulos transferidos, es preferible usar MediaItem.SubtitleConfiguration en su lugar.
  • ConcatenatingMediaSource2: Combina varias fuentes multimedia para que se reproduzcan de forma consecutiva. La estructura multimedia visible para el usuario expone un único 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 utilizar los métodos de la API de playlist, como Player.addMediaItem.
  • SilenceMediaSource: Genera silencio durante un tiempo específico que es útil para llenar vacíos.
  • AdsMediaSource: Extiende una fuente de contenido multimedia 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.