Bắt đầu

Để bắt đầu sử dụng ExoPlayer, bạn cần thực hiện các bước sau:

  1. Thêm ExoPlayer làm phần phụ thuộc vào dự án của bạn.
  2. Tạo một thực thể ExoPlayer.
  3. Đính kèm trình phát vào một khung hiển thị (để xuất video và nhận dữ liệu đầu vào của người dùng).
  4. Chuẩn bị trình phát bằng MediaItem để phát.
  5. Giải phóng trình phát khi hoàn tất.

Các bước này sẽ được mô tả chi tiết hơn ở phần sau. Để xem ví dụ hoàn chỉnh, hãy tham khảo PlayerActivity trong ứng dụng minh hoạ chính.

Thêm ExoPlayer làm phần phụ thuộc

Để sử dụng ExoPlayer trong ứng dụng, hãy thêm các mô-đun bắt buộc và bật tính năng hỗ trợ Java 8.

Thêm mô-đun ExoPlayer

Cách dễ nhất để bắt đầu sử dụng AndroidX Media3 là thêm các phần phụ thuộc gradle của thư viện bạn cần vào tệp build.gradle trong mô-đun ứng dụng của bạn.

Ví dụ: để phụ thuộc vào ExoPlayer có hỗ trợ phát DASH và các thành phần giao diện người dùng, bạn có thể thêm các phần phụ thuộc vào các mô-đun như sau:

Kotlin

implementation("androidx.media3:media3-exoplayer:1.11.1")
implementation("androidx.media3:media3-exoplayer-dash:1.11.1")
implementation("androidx.media3:media3-ui:1.11.1")
implementation("androidx.media3:media3-ui-compose-material3:1.11.1")

Groovy

implementation "androidx.media3:media3-exoplayer:1.11.1"
implementation "androidx.media3:media3-exoplayer-dash:1.11.1"
implementation "androidx.media3:media3-ui:1.11.1"
implementation("androidx.media3:media3-ui-compose-material3:1.11.1")

trong đó 1.11.1 là phiên bản bạn muốn dùng (bạn có thể tham khảo ghi chú phát hành để biết phiên bản mới nhất). Tất cả các mô-đun phải có cùng phiên bản.

AndroidX Media3 có các mô-đun thư viện phụ thuộc vào thư viện bên ngoài để cung cấp chức năng bổ sung. Một số có sẵn trong kho lưu trữ Maven, trong khi một số khác phải được tạo theo cách thủ công. Duyệt xem thư mục thư viện và xem từng tệp README để biết thông tin chi tiết.

Bạn có thể xem thêm thông tin về các mô-đun thư viện hiện có trên trang AndroidX Media của Google Maven.

Bật tính năng hỗ trợ Java 8

Nếu chưa bật, bạn cần bật ít nhất là hỗ trợ Java 8 trong tất cả tệp build.gradle phụ thuộc vào ExoPlayer bằng cách thêm đoạn mã sau vào phần android:

compileOptions {
  targetCompatibility JavaVersion.VERSION_1_8
}

Tạo trình phát

Bạn có thể tạo một thực thể ExoPlayer bằng ExoPlayer.Builder, cung cấp một loạt các tuỳ chọn tuỳ chỉnh. Đoạn mã sau đây là ví dụ đơn giản nhất về cách tạo một thực thể.

Kotlin

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

Java

ExoPlayer player = new ExoPlayer.Builder(context).build();

Lưu ý về tính năng tạo chuỗi

Bạn phải truy cập vào các thực thể ExoPlayer từ một luồng ứng dụng duy nhất. Trong phần lớn các trường hợp, đây phải là luồng chính của ứng dụng. Bạn bắt buộc phải sử dụng luồng chính của ứng dụng khi dùng các thành phần giao diện người dùng của ExoPlayer hoặc tiện ích IMA.

Bạn có thể chỉ định rõ ràng luồng mà một thực thể ExoPlayer phải truy cập bằng cách truyền Looper khi tạo trình phát. Nếu không có Looper nào được chỉ định, thì Looper của luồng mà trình phát được tạo sẽ được sử dụng. Nếu luồng đó không có Looper, thì Looper của luồng chính của ứng dụng sẽ được sử dụng. Trong mọi trường hợp, bạn có thể truy vấn Looper của luồng mà từ đó người chơi phải được truy cập bằng cách sử dụng Player.getApplicationLooper.

Để biết thêm thông tin về mô hình phân luồng của ExoPlayer, hãy xem phần "Mô hình phân luồng" của ExoPlayer Javadoc.

Đính kèm trình phát vào một khung hiển thị

Thư viện media3-ui cung cấp một loạt thành phần giao diện người dùng tạo sẵn để phát nội dung nghe nhìn. Trong đó có PlayerView, đóng gói PlayerControlView, SubtitleView và Surface mà video được kết xuất. Bạn có thể đưa PlayerView vào tệp xml bố cục của ứng dụng. Ví dụ: để liên kết trình phát với khung hiển thị, hãy làm như sau:

Kotlin

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

Java

// Bind the player to the view.
playerView.setPlayer(player);

Bạn không bắt buộc phải sử dụng các thành phần giao diện người dùng tạo sẵn của Media3. Đối với các ứng dụng video triển khai giao diện người dùng riêng, bạn có thể đặt SurfaceView, TextureView, SurfaceHolder hoặc Surface mục tiêu bằng cách sử dụng các phương thức setVideoSurfaceView, setVideoTextureView, setVideoSurfaceHolder và setVideoSurface tương ứng của Trình phát. Bạn có thể dùng lệnh gọi lại Listener.onCues để nhận phụ đề cần hiển thị trong khi phát và dùng setImageOutput để nhận hình ảnh đã giải mã.

Để mang lại trải nghiệm thoải mái hơn cho người dùng, hãy cân nhắc thêm thuộc tính keepScreenOn. Bạn có thể tìm hiểu các hành động khác khiến thiết bị luôn ở trạng thái thức trong các trang công việc ở chế độ nền.

android:keepScreenOn="true"

Nếu ứng dụng của bạn dùng Jetpack Compose cho giao diện người dùng, thì bạn có thể dùng thành phần kết hợp Player trong thư viện media3-ui-compose-material3. Player hiển thị video và bao gồm các giá trị được điền sẵn cho các vùng điều khiển chế độ phát. Để đính kèm đối tượng androidx.media3.common.Player vào thành phần kết hợp androidx.media3.ui.compose.material3.Player, bạn chỉ cần truyền đối tượng đó dưới dạng đối số:

// Bind the player to the composable.
Player(player = player)

Đọc thêm về cách sử dụng các thành phần giao diện người dùng Media3 và cách tuỳ chỉnh các thành phần đó trên trang Giao diện người dùng.

Điền danh sách phát và chuẩn bị trình phát

Trong ExoPlayer, mọi nội dung nghe nhìn đều được biểu thị bằng một MediaItem. Để phát một nội dung nghe nhìn, bạn cần tạo một MediaItem tương ứng, thêm nội dung đó vào trình phát, chuẩn bị trình phát và gọi play để bắt đầu phát:

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 hỗ trợ trực tiếp danh sách phát, vì vậy, bạn có thể chuẩn bị trình phát với nhiều mục nội dung nghe nhìn để phát lần lượt:

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

Bạn có thể cập nhật danh sách phát trong khi phát mà không cần chuẩn bị lại trình phát. Đọc thêm về cách điền sẵn và thao tác với danh sách phát trên trang Danh sách phát. Đọc thêm về các lựa chọn có sẵn khi tạo mục nội dung nghe nhìn, chẳng hạn như cắt và đính kèm tệp phụ đề, trên trang Mục nội dung nghe nhìn.

Điều khiển trình phát

Sau khi trình phát được chuẩn bị, bạn có thể điều khiển quá trình phát bằng cách gọi các phương thức trên trình phát. Dưới đây là một số phương thức thường dùng nhất:

  • play và pause bắt đầu và tạm dừng phát.
  • seekTo cho phép tua trong nội dung nghe nhìn.
  • hasPrevious, hasNext, previous và next cho phép di chuyển trong danh sách phát.
  • setRepeatMode kiểm soát việc có lặp lại nội dung nghe nhìn hay không và cách lặp lại.
  • setShuffleModeEnabled điều khiển chế độ phát ngẫu nhiên danh sách phát.
  • setPlaybackParameters điều chỉnh tốc độ phát và cao độ âm thanh.
  • setScrubbingModeEnabled tối ưu hoá trình phát cho các thao tác tua thường xuyên trong khi người dùng kéo thanh tua. Để biết thông tin chi tiết, hãy xem phần Chế độ kéo để tua.

Nếu trình phát được liên kết với PlayerView hoặc PlayerControlView, thì hoạt động tương tác của người dùng với các thành phần này sẽ khiến các phương thức tương ứng trên trình phát được gọi.

Giải phóng trình phát

Bạn cần giải phóng trình phát khi không cần đến nữa để giải phóng các tài nguyên có giới hạn (chẳng hạn như bộ giải mã video) cho các ứng dụng khác sử dụng. Bạn có thể thực hiện việc này bằng cách gọi ExoPlayer.release.