ExoPlayer hỗ trợ DASH với nhiều định dạng vùng chứa. Bạn phải loại bỏ các luồng nội dung nghe nhìn, tức là video, âm thanh và văn bản phải được xác định trong các phần tử AdaptationSet
riêng biệt trong tệp kê khai DASH (CEA-608 là một trường hợp ngoại lệ theo mô tả trong bảng dưới đây). Các định dạng mẫu âm thanh và video chứa trong đó cũng phải được hỗ trợ (xem phần định dạng mẫu để biết thông tin chi tiết).
Tính năng | Có thể làm | Bình luận |
---|---|---|
Vùng chứa | ||
FMP4 | NÊN | Chỉ các luồng đã được lọc |
WebM | NÊN | Chỉ các luồng đã được lọc |
Tiếng Matroska | NÊN | Chỉ các luồng đã được lọc |
MPEG-TS | KHÔNG NÊN | Chưa lên kế hoạch hỗ trợ |
Phụ đề chi tiết | ||
TTML | NÊN | Thô hoặc nhúng trong FMP4 theo ISO/IEC 14496-30 |
WebVTT | NÊN | Thô hoặc nhúng trong FMP4 theo ISO/IEC 14496-30 |
CEA-608 | NÊN | Được nhúng trong FMP4 khi được báo hiệu bằng bộ mô tả Hỗ trợ tiếp cận theo chuẩn SCTE |
CEA-708 | NÊN | Được nhúng trong FMP4 khi được báo hiệu bằng bộ mô tả Hỗ trợ tiếp cận theo chuẩn SCTE |
Siêu dữ liệu | ||
Siêu dữ liệu về EMSG | NÊN | Được nhúng trong FMP4 |
Bảo vệ nội dung | ||
Widevine | NÊN | Lược đồ "cenc": API 19 trở lên; lược đồ "cbcs": API 25 trở lên |
PlayReady SL2000 | NÊN | Android TV, chỉ giao thức "cenc" |
Khoá Xoá | NÊN | Chỉ API 21 trở lên, giao thức "cenc" |
Phát trực tiếp | ||
Phát trực tiếp định kỳ | NÊN | |
Phát trực tiếp CMAF độ trễ thấp nhất | NÊN | |
Dữ liệu ứng dụng đa phương tiện chung (CMCD) | NÊN | Hướng dẫn tích hợp |
Sử dụng MediaItem
Để phát luồng DASH, bạn cần phụ thuộc vào mô-đun DASH.
Kotlin
implementation("androidx.media3:media3-exoplayer-dash:1.3.1")
Groovy
implementation "androidx.media3:media3-exoplayer-dash:1.3.1"
Sau đó, bạn có thể tạo MediaItem
cho URI MPD DASH và truyền tệp đó cho trình phát.
Kotlin
// Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(dashUri)) // Prepare the player. player.prepare()
Java
// Create a player instance. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(dashUri)); // Prepare the player. player.prepare();
Nếu URI của bạn không kết thúc bằng .mpd
, bạn có thể chuyển MimeTypes.APPLICATION_MPD
đến setMimeType
của MediaItem.Builder
để biểu thị rõ loại nội dung.
ExoPlayer sẽ tự động điều chỉnh giữa các bản trình bày được xác định trong tệp kê khai, có tính đến cả băng thông có sẵn và khả năng của thiết bị.
Sử dụng DashMediaSource
Để có thêm lựa chọn tuỳ chỉnh, bạn có thể tạo DashMediaSource
và truyền trực tiếp đến trình phát thay vì MediaItem
.
Kotlin
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory() // Create a dash media source pointing to a dash manifest uri. val mediaSource: MediaSource = DashMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(dashUri)) // Create a player instance which gets an adaptive track selector by default. val player = ExoPlayer.Builder(context).build() // Set the media source to be played. player.setMediaSource(mediaSource) // Prepare the player. player.prepare()
Java
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory(); // Create a dash media source pointing to a dash manifest uri. MediaSource mediaSource = new DashMediaSource.Factory(dataSourceFactory) .createMediaSource(MediaItem.fromUri(dashUri)); // Create a player instance which gets an adaptive track selector by default. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the media source to be played. player.setMediaSource(mediaSource); // Prepare the player. player.prepare();
Truy cập tệp kê khai
Bạn có thể truy xuất tệp kê khai hiện tại bằng cách gọi Player.getCurrentManifest
.
Đối với DASH, bạn nên truyền đối tượng được trả về thành DashManifest
. Lệnh gọi lại onTimelineChanged
của Player.Listener
cũng được gọi mỗi khi tệp kê khai được tải. Điều này sẽ xảy ra một lần đối với nội dung theo yêu cầu và có thể xảy ra nhiều lần đối với nội dung phát trực tiếp. Đoạn mã sau đây cho thấy cách một ứng dụng có thể thực hiện một việc nào đó bất cứ khi nào tệp kê khai được tải.
Kotlin
player.addListener( object : Player.Listener { override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) { val manifest = player.currentManifest if (manifest is DashManifest) { // Do something with the manifest. } } } )
Java
player.addListener( new Player.Listener() { @Override public void onTimelineChanged( Timeline timeline, @Player.TimelineChangeReason int reason) { Object manifest = player.getCurrentManifest(); if (manifest != null) { DashManifest dashManifest = (DashManifest) manifest; // Do something with the manifest. } } });
Tuỳ chỉnh tính năng phát
ExoPlayer cung cấp nhiều cách để bạn điều chỉnh trải nghiệm phát theo nhu cầu của ứng dụng. Xem trang Tuỳ chỉnh để biết ví dụ.