開始使用

如果是簡單的用途，開始使用 ExoPlayer 時需完成下列步驟：

1. 將 ExoPlayer 新增為專案的依附元件。
2. 建立 ExoPlayer 執行個體。
3. 將播放器附加至檢視畫面 (用於影片輸出和使用者輸入)。
4. 使用 MediaItem 讓玩家準備好進行播放。
5. 完成後請放開播放器。

這些步驟詳細說明如下。如需完整範例，請參閱主要試用版應用程式中的 PlayerActivity。

將 ExoPlayer 新增為依附元件

新增 ExoPlayer 模組

如要開始使用 AndroidX Media3，最簡單的方法就是在應用程式模組的 build.gradle 檔案中，為所需的程式庫新增 Gradle 依附元件。

舉例來說，如要依附提供 DASH 播放支援和 UI 元件的 ExoPlayer，您可以在模組中新增依附元件，如下所示：

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")

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 例項。以下程式碼是建立執行個體的最簡單範例。

val player = ExoPlayer.Builder(context).build()

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 中。例如將播放器繫結至檢視畫面：

// Bind the player to the view.
playerView.player = player

// 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 以開始播放：

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

// 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 直接支援播放清單，因此可以為播放器準備含有多個媒體項目，以便連續播放：

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

// 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 即可達成這個效果。