如果是簡單的用途,開始使用 ExoPlayer
時需完成下列步驟:
- 將 ExoPlayer 新增為專案的依附元件。
- 建立
ExoPlayer
執行個體。 - 將播放器附加至檢視畫面 (用於影片輸出和使用者輸入)。
- 使用
MediaItem
讓玩家準備好進行播放。 - 完成後請放開播放器。
這些步驟詳細說明如下。如需完整範例,請參閱主要試用版應用程式中的 PlayerActivity
。
將 ExoPlayer 新增為依附元件
新增 ExoPlayer 模組
如要開始使用 AndroidX Media3,最簡單的方法就是在應用程式模組的 build.gradle
檔案中,為所需的程式庫新增 Gradle 依附元件。
舉例來說,如要依附提供 DASH 播放支援和 UI 元件的 ExoPlayer,您可以在模組中新增依附元件,如下所示:
Kotlin
implementation("androidx.media3:media3-exoplayer:1.3.1") implementation("androidx.media3:media3-exoplayer-dash:1.3.1") implementation("androidx.media3:media3-ui:1.3.1")
Groovy
implementation "androidx.media3:media3-exoplayer:1.3.1" implementation "androidx.media3:media3-exoplayer-dash:1.3.1" implementation "androidx.media3:media3-ui:1.3.1"
其中 1.3.1 是偏好的版本 (如需最新版本,請參閱版本資訊)。所有模組的版本都必須相同。
AndroidX Media3 的程式庫模組會依附外部程式庫來提供額外功能。一些工具可從 Maven 存放區取得,有些則必須手動建構。瀏覽程式庫目錄並查看個別 README 檔案。
如要進一步瞭解可用的程式庫模組,請參閱 Google Maven AndroidX 媒體頁面。
開啟 Java 8 支援
如果尚未啟用,您必須在所有依附 ExoPlayer 的 build.gradle
檔案中啟用 Java 8 支援功能,方法是將以下內容新增至 android
區段:
compileOptions {
targetCompatibility JavaVersion.VERSION_1_8
}
啟用 multidex
如果 Gradle minSdkVersion
為 20 以下,請啟用 Multidex,以免發生建構錯誤。
建立播放器
您可以使用提供一系列自訂選項的 ExoPlayer.Builder
建立 ExoPlayer
例項。以下程式碼是建立執行個體的最簡單範例。
Kotlin
val player = ExoPlayer.Builder(context).build()
Java
ExoPlayer player = new ExoPlayer.Builder(context).build();
執行緒附註
ExoPlayer 執行個體必須透過單一應用程式執行緒存取。在大多數情況下,這應該是應用程式的主執行緒。使用 ExoPlayer 的 UI 元件或 IMA 擴充功能時,請務必使用應用程式的主要執行緒。
建立玩家時,可以透過傳遞 Looper
明確指定必須存取 ExoPlayer 執行個體的執行緒。如未指定 Looper
,系統會使用建立玩家的執行緒的 Looper
;如果該執行緒沒有 Looper
,則會使用應用程式主執行緒的 Looper
。在所有情況下,您可以使用 Player.getApplicationLooper
查詢必須存取玩家的執行緒 Looper
。
如要進一步瞭解 ExoPlayer 的執行緒模型,請參閱 ExoPlayer Javadoc 的「執行緒模型」一節。
將播放器附加至檢視畫面
ExoPlayer 程式庫提供多種預先建構的 UI 元件,可用於媒體播放。其中包括 PlayerView
,可封裝 PlayerControlView
、SubtitleView
,以及算繪影片的 Surface
。PlayerView
可納入應用程式的版面配置 XML 中。例如將播放器繫結至檢視畫面:
Kotlin
// Bind the player to the view. playerView.player = player
Java
// Bind the player to the view. playerView.setPlayer(player);
您也可以將 PlayerControlView
做為獨立元件使用,這對於僅音訊的用途相當實用。
您可以自行選擇是否要使用 ExoPlayer 預先建構的 UI 元件。針對實作專屬 UI 的影片應用程式,您可以使用 ExoPlayer 的 setVideoSurfaceView
、setVideoTextureView
、setVideoSurfaceHolder
和 setVideoSurface
方法設定目標 SurfaceView
、TextureView
、SurfaceHolder
或 Surface
。ExoPlayer 的 addTextOutput
方法可用於接收應在播放期間顯示的字幕。
填入播放清單,並為播放器做好準備
在 ExoPlayer 中,每部媒體都會以 MediaItem
表示。如要播放媒體,您需要建構對應的 MediaItem
、將其新增至播放器、為播放器做好準備,並呼叫 play
以開始播放:
Kotlin
// Build the media item. val mediaItem = MediaItem.fromUri(videoUri) // Set the media item to be played. player.setMediaItem(mediaItem) // Prepare the player. player.prepare() // Start the playback. player.play()
Java
// Build the media item. MediaItem mediaItem = MediaItem.fromUri(videoUri); // Set the media item to be played. player.setMediaItem(mediaItem); // Prepare the player. player.prepare(); // Start the playback. player.play();
ExoPlayer 直接支援播放清單,因此可以為播放器準備含有多個媒體項目,以便連續播放:
Kotlin
// Build the media items. val firstItem = MediaItem.fromUri(firstVideoUri) val secondItem = MediaItem.fromUri(secondVideoUri) // Add the media items to be played. player.addMediaItem(firstItem) player.addMediaItem(secondItem) // Prepare the player. player.prepare() // Start the playback. player.play()
Java
// Build the media items. MediaItem firstItem = MediaItem.fromUri(firstVideoUri); MediaItem secondItem = MediaItem.fromUri(secondVideoUri); // Add the media items to be played. player.addMediaItem(firstItem); player.addMediaItem(secondItem); // Prepare the player. player.prepare(); // Start the playback. player.play();
播放清單可在播放期間更新,而不需要重新讓播放器進行準備。如要進一步瞭解如何填入及操控播放清單,請前往播放清單頁面。如要進一步瞭解建構媒體項目時可用的不同選項,例如裁剪及附加字幕檔案,請參閱媒體項目頁面。
操控播放器
播放器準備就緒後,即可透過呼叫播放器的方法控製播放內容。以下列舉一些最常用的方法:
play
和pause
可開始及暫停播放。seekTo
可讓你在媒體中搜尋。hasPrevious
、hasNext
、previous
和next
允許瀏覽播放清單。setRepeatMode
可控制媒體是否循環播放,以及循環播放方式。- 「
setShuffleModeEnabled
」可控製播放清單隨機播放功能。 setPlaybackParameters
可調整播放速度和音訊音調。
如果玩家繫結了 PlayerView
或 PlayerControlView
,當使用者與這些元件互動時,系統會叫用玩家上的對應方法。
釋出播放器
請務必在不再需要時釋出播放器,以便釋出有限的資源 (例如影片解碼器),供其他應用程式使用。只要呼叫 ExoPlayer.release
即可達成這個效果。