Bắt đầu

Mẹo: Một cách khác để bắt đầu là tham gia lớp học lập trình về ExoPlayer.

Đối với các trường hợp sử dụng đơn giản, việc bắt đầu với ExoPlayer bao gồm việc triển khai 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ị (cho đầu ra video và hoạt động đầu vào của người dùng).
4. Chuẩn bị trình phát bằng MediaItem để phát.
5. Thả trình phát khi hoàn tất.

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

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

Thêm các 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 vào các thư viện bạn cần trong tệp build.gradle của mô-đun ứng dụng.

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 trên các mô-đun như sau:

Kotlin

implementation("androidx.media3:media3-exoplayer:1.4.1")
implementation("androidx.media3:media3-exoplayer-dash:1.4.1")
implementation("androidx.media3:media3-ui:1.4.1")

Groovy

implementation "androidx.media3:media3-exoplayer:1.4.1"
implementation "androidx.media3:media3-exoplayer-dash:1.4.1"
implementation "androidx.media3:media3-ui:1.4.1"

trong đó 1.4.1 là phiên bản ưu tiên của bạn (bạn có thể tìm thấy phiên bản mới nhất bằng cách tham khảo ghi chú phát hành). Tất cả mô-đun phải cùng một phiên bản.

AndroidX Media3 có các mô-đun thư viện phụ thuộc vào các 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 qua thư mục thư viện và xem các tệp README riêng lẻ để 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 có sẵn trên trang Nội dung đa phương tiện AndroidX 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 năng hỗ trợ Java 8 trong tất cả tệp build.gradle phụ thuộc vào ExoPlayer bằng cách thêm nội dung sau vào phần android:

compileOptions {
  targetCompatibility JavaVersion.VERSION_1_8
}

Bật multidex

Nếu Gradle minSdkVersion của bạn là 20 trở xuống, bạn nên bật multidex để ngăn chặn lỗi bản dựng.

Tạo trình phát

Bạn có thể tạo một thực thể ExoPlayer bằng ExoPlayer.Builder. Lớp này cung cấp một loạt tuỳ chọn tuỳ chỉnh. 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ề việc tạo luồng

Các thực thể ExoPlayer phải được truy cập từ một luồng ứng dụng. Trong phần lớn 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 sử 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õ luồng mà thực thể ExoPlayer phải được truy cập bằng cách truyền Looper khi tạo trình phát. Nếu không chỉ định Looper, thì Looper của luồng mà trình phát được tạo sẽ được sử dụng, hoặc 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ừ đó trình phát phải được truy cập bằng Player.getApplicationLooper.

Lưu ý: Nếu bạn thấy IllegalStateException được gửi cùng với thông báo "Người chơi được truy cập trên luồng không chính xác", thì một số mã trong ứng dụng của bạn đang truy cập vào một thực thể ExoPlayer trên luồng không chính xác (dấu vết ngăn xếp của ngoại lệ cho bạn biết vị trí).

Để 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" trong ExoPlayer Javadoc.

Đính kèm trình phát vào chế độ xem

Thư viện ExoPlayer cung cấp một loạt các thành phần giao diện người dùng tạo sẵn để phát nội dung đa phương tiện. Các đối tượng này bao gồm PlayerView đóng gói PlayerControlView, SubtitleView và Surface mà video được kết xuất. Bạn có thể đưa PlayerView vào 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ị:

Kotlin

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

Java

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

Bạn cũng có thể sử dụng PlayerControlView làm thành phần độc lập, rất hữu ích cho các trường hợp sử dụng chỉ âm thanh.

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 dựng sẵn của ExoPlayer. Đố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 mục tiêu SurfaceView, TextureView, SurfaceHolder hoặc Surface tương ứng bằng các phương thức setVideoSurfaceView, setVideoTextureView, setVideoSurfaceHolder và setVideoSurface của ExoPlayer. Bạn có thể sử dụng phương thức addTextOutput của ExoPlayer để nhận phụ đề cần hiển thị trong khi phát.

Đ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 đượ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 đa phương tiệ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 và thao tác với danh sách phát trên trang Danh sách phát. Hãy đọc thêm về các tuỳ 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.

Lưu ý: Media3 ExoPlayer chuyển đổi các mục nội dung nghe nhìn thành các thực thể MediaSource mà ứng dụng cần trong nội bộ. Hãy đọc thêm về quy trình này và cách tuỳ chỉnh quy trình này trên trang Nguồn nội dung nghe nhìn. Bạn có thể cung cấp MediaSource trực tiếp cho người chơi bằng cách sử dụng ExoPlayer.setMediaSource(s) và ExoPlayer.addMediaSource(s).

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

Sau khi chuẩn bị trình phát, bạn có thể điều khiển chế độ 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 tìm kiếm trong nội dung nghe nhìn.
• hasPrevious, hasNext, previous và next cho phép di chuyển qua 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 tính năng phát ngẫu nhiên danh sách phát.
• setPlaybackParameters điều chỉnh tốc độ phát và độ cao âm thanh.

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.

Phát hành trình phát

Điều quan trọng là phải phát hành trình phát khi không còn cần thiết nữa để giải phóng các tài nguyên có 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.