在 ExoPlayer 中,每段媒體都會以 MediaItem
表示。不過,玩家在內部需要 MediaSource
執行個體才能播放內容。播放器使用 MediaSource.Factory
從媒體項目建立這些項目。
根據預設,玩家會使用 DefaultMediaSourceFactory
,建立下列內容 MediaSource
實作的執行個體:
- DASH 的
DashMediaSource
。 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
,因此看起來就像單一項目。如果這類修改是播放不應該顯示為單一項目的多個項目,建議您改用 playlist API 方法,例如Player.addMediaItem
。SilenceMediaSource
:在指定期間產生靜音,有助於填補缺口。AdsMediaSource
:使用用戶端廣告插播功能擴充媒體來源。詳情請參閱廣告插播指南。ServerSideAdInsertionMediaSource
:使用伺服器端廣告插入功能擴充媒體來源。詳情請參閱廣告插播指南。