媒体来源

在 ExoPlayer 中，每一段媒体内容都由 MediaItem 表示。不过，在内部，播放器需要 MediaSource 实例才能播放内容。播放器使用 MediaSource.Factory 从媒体内容创建这些内容。

默认情况下，播放器使用 DefaultMediaSourceFactory，它可以创建以下内容 MediaSource 实现的实例：

  • DashMediaSource（适用于 DASH）。
  • SsMediaSource（适用于 SmoothStreaming）。
  • HlsMediaSource（适用于 HLS）。
  • ProgressiveMediaSource，适用于常规媒体文件。
  • RtspMediaSource（适用于 RTSP）。

DefaultMediaSourceFactory 还可以根据相应媒体内容的属性创建更复杂的媒体来源。“媒体内容”页面对此进行了更详细的介绍。

对于需要媒体源设置（播放器的默认配置不支持）的应用，有多个自定义选项。

自定义媒体来源创建

构建播放器时，可以注入 MediaSource.Factory。例如，如果应用想要插入广告并使用 CacheDataSource.Factory 来支持缓存，则可以将 DefaultMediaSourceFactory 实例配置为符合这些要求，并在构建播放器期间注入：

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

DefaultMediaSourceFactory JavaDoc 详细介绍了可用的选项。

此外，还可以注入自定义 MediaSource.Factory 实现，例如用于支持创建自定义媒体来源类型。系统会调用工厂的 createMediaSource(MediaItem)，为添加到播放列表的每个媒体内容创建媒体源。

基于媒体来源的播放列表 API

ExoPlayer 接口定义了接受媒体来源（而非媒体内容）的其他播放列表方法。这样就可以绕过播放器的内部 MediaSource.Factory，直接将媒体来源实例传递给播放器：

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

高级媒体来源组合

ExoPlayer 提供了多个 MediaSource 实现，用于修改和组合其他 MediaSource 实例。在必须组合使用多项自定义设置且没有任何更简单的设置路径足以满足需求的情况下，这些方法最为实用。

  • ClippingMediaSource：允许将媒体剪辑到指定的时间戳范围。 如果这是唯一的修改，最好改用 MediaItem.ClippingConfiguration。
  • FilteringMediaSource：将可用轨道过滤为指定类型，例如，仅显示包含音频和视频的文件中的视频轨道。如果这是唯一的修改，最好改用轨道选择参数。
  • MergingMediaSource：合并多个媒体源以并行播放。在几乎所有情况下，建议将 adjustPeriodTimeOffsets 和 clipDurations 设置为 true 来调用构造函数，以确保所有来源都同时开始和结束。如果执行此修改是为了添加旁加载字幕，最好改用 MediaItem.SubtitleConfiguration。
  • ConcatenatingMediaSource2：合并多个媒体源以连续播放。用户可见的媒体结构会公开单个 Timeline.Window，这意味着它看起来像一个项目。如果进行此修改是为了播放不应看起来像单项的多项内容，最好改用 Player.addMediaItem 等播放列表 API 方法。
  • SilenceMediaSource：在指定时长内生成无声，有助于填补缺口。
  • AdsMediaSource：使用客户端广告插入功能扩展媒体来源。如需了解详情，请参阅广告插入指南。
  • ServerSideAdInsertionMediaSource：使用服务器端广告插入功能扩展媒体来源。如需了解详情，请参阅广告插入指南。