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:
DashMediaSource
para DASH.SsMediaSource
para SmoothStreaming.HlsMediaSource
para HLS.ProgressiveMediaSource
para archivos multimedia normalesRtspMediaSource
para RTSP.
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 usarMediaItem.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 conadjustPeriodTimeOffsets
yclipDurations
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 usarMediaItem.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 únicoTimeline.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, comoPlayer.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.