媒體來源

在 ExoPlayer 中，每段媒體都會以 MediaItem 表示。不過，玩家在內部需要 MediaSource 執行個體才能播放內容。播放器使用 MediaSource.Factory 從媒體項目建立這些項目。

根據預設，玩家會使用 DefaultMediaSourceFactory，建立下列內容 MediaSource 實作的執行個體：

• DASH 的DashMediaSource。
• SsMediaSource 代表 SmoothStreaming。
• HlsMediaSource 代表 HLS。
• ProgressiveMediaSource 代表一般媒體檔案。
• RtspMediaSource 代表 RTSP。

DefaultMediaSourceFactory 也可以根據對應媒體項目的屬性，建立更複雜的媒體來源。詳情請參閱媒體項目頁面。

如果應用程式需要的媒體來源設定不受播放器預設設定支援，有多種自訂選項可供選擇。

自訂媒體來源建立作業

建構播放器時，可以插入 MediaSource.Factory。舉例來說，如果應用程式想要插入廣告，並使用 CacheDataSource.Factory 支援快取，則可設定 DefaultMediaSourceFactory 的執行個體以符合這些要求，並在玩家建構期間插入：

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

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，並將媒體來源執行個體直接傳遞給玩家：

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

// 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，因此看起來就像單一項目。如果這類修改是播放不應該顯示為單一項目的多個項目，建議您改用 playlist API 方法，例如 Player.addMediaItem。
• SilenceMediaSource：在指定期間產生靜音，有助於填補缺口。
• AdsMediaSource：使用用戶端廣告插播功能擴充媒體來源。詳情請參閱廣告插播指南。
• ServerSideAdInsertionMediaSource：使用伺服器端廣告插入功能擴充媒體來源。詳情請參閱廣告插播指南。