ExoPlayer hỗ trợ SmoothStreaming bằng định dạng vùng chứa FMP4. Các luồng nội dung đa phương tiện phải được giải mã, nghĩa là video, âm thanh và văn bản phải được xác định trong các phần tử StreamIndex riêng biệt trong tệp kê khai SmoothStreaming. Định dạng mẫu âm thanh và video có trong tệp 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 | CÓ | Chỉ các luồng đã giải mã |
| Phụ đề chi tiết/phụ đề | ||
| TTML | CÓ | Được nhúng trong FMP4 |
| Biện pháp bảo vệ nội dung | ||
| PlayReady SL2000 | CÓ | Chỉ phát hành cho Android TV |
| Phát trực tiếp | ||
| Phát trực tiếp thông thường | CÓ | |
| Dữ liệu ứng dụng nội dung nghe nhìn phổ biến (CMCD) | CÓ | Hướng dẫn tích hợp |
Sử dụng MediaItem
Để phát luồng SmoothStreaming, bạn cần phụ thuộc vào mô-đun SmoothStreaming.
Kotlin
implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.5.0")
Groovy
implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.5.0"
Sau đó, bạn có thể tạo MediaItem cho URI tệp kê khai SmoothStreaming và truyền URI đó đến 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(ssUri)) // 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(ssUri)); // Prepare the player. player.prepare();
Nếu URI của bạn không kết thúc bằng .ism/Manifest, bạn có thể truyền MimeTypes.APPLICATION_SS đến setMimeType của MediaItem.Builder để chỉ 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 hiện có và chức năng của thiết bị.
Sử dụng SsMediaSource
Để có thêm tuỳ chọn tuỳ chỉnh, bạn có thể tạo SsMediaSource và truyền trực tiếp SsMediaSource đó đến trình phát thay vì MediaItem.
Kotlin
// Create a data source factory. val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory() // Create a SmoothStreaming media source pointing to a manifest uri. val mediaSource: MediaSource = SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri)) // Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media source to be played. player.setMediaSource(mediaSource) // Prepare the player. player.prepare()
Java
// Create a data source factory. DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory(); // Create a SmoothStreaming media source pointing to a manifest uri. MediaSource mediaSource = new SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri)); // Create a player instance. 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 vào 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 SmoothStreaming, bạn nên truyền đối tượng được trả về đến SsManifest. Lệnh gọi lại onTimelineChanged của Player.Listener cũng được gọi bất cứ khi nào tệp kê khai được tải. Việc này sẽ xảy ra một lần đối với nội dung theo yêu cầu và có thể nhiều lần đối với nội dung phát trực tiếp. Đoạn mã sau đây cho biết cách một ứng dụng có thể làm gì đó 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 SsManifest) { // 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) { SsManifest ssManifest = (SsManifest) manifest; // Do something with the manifest. } } });
Tuỳ chỉnh chế độ phát
ExoPlayer cung cấp nhiều cách để bạn điều chỉnh trải nghiệm phát sao cho phù hợp với nhu cầu của ứng dụng. Hãy xem trang Tuỳ chỉnh để tham khảo ví dụ.