SmoothStreaming
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
ExoPlayer hỗ trợ SmoothStreaming bằng định dạng vùng chứa FMP4. Các luồng nội dung nghe nhìn phải được tách kênh, tức 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 hỗ trợ |
Bình luận |
| Vùng chứa |
|
|
| FMP4 |
CÓ |
Chỉ luồng đã tách |
| Phụ đề |
|
|
| TTML |
CÓ |
Được nhúng trong FMP4 |
| 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 theo cách 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 |
Để phát một luồng SmoothStreaming, bạn cần phải phụ thuộc vào mô-đun SmoothStreaming.
Kotlin
implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.8.0")
Groovy
implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.8.0"
Sau đó, bạn có thể tạo một 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 để cho biết 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à khả năng của thiết bị.
Để có thêm các lựa chọn tuỳ chỉnh, bạn có thể tạo một SsMediaSource và truyền trực tiếp đối tượng này đến trình phát thay vì truyền 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. Đ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ể 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 điều 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 cho phù hợp với nhu cầu của ứng dụng. Hãy xem trang Tuỳ chỉnh để tham khảo các ví dụ.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-08-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-27 UTC."],[],[],null,["# SmoothStreaming\n\nExoPlayer supports SmoothStreaming with the FMP4 container format. Media streams\nmust be demuxed, meaning that video, audio, and text must be defined in distinct\nStreamIndex elements in the SmoothStreaming manifest. The contained audio and\nvideo sample formats must also be supported (see the\n[sample formats](/media/media3/exoplayer/supported-formats#sample-formats) section for details).\n\n| Feature | Supported | Comments |\n|-------------------------------------|-----------|---------------------------------------------------------|\n| **Containers** | | |\n| FMP4 | YES | Demuxed streams only |\n| **Closed captions/subtitles** | | |\n| TTML | YES | Embedded in FMP4 |\n| **Content protection** | | |\n| PlayReady SL2000 | YES | Android TV only |\n| **Live playback** | | |\n| Regular live playback | YES | |\n| **Common Media Client Data (CMCD)** | YES | [Integration Guide](/guide/topics/media/exoplayer/cmcd) |\n\nUsing MediaItem\n---------------\n\nTo play a SmoothStreaming stream, you need to depend on the SmoothStreaming\nmodule. \n\n### Kotlin\n\n```kotlin\nimplementation(\"androidx.media3:media3-exoplayer-smoothstreaming:1.8.0\")\n```\n\n### Groovy\n\n```groovy\nimplementation \"androidx.media3:media3-exoplayer-smoothstreaming:1.8.0\"\n```\n\nYou can then create a `MediaItem` for a SmoothStreaming manifest URI and pass it\nto the player. \n\n### Kotlin\n\n```kotlin\n// Create a player instance.\nval player = ExoPlayer.Builder(context).build()\n// Set the media item to be played.\nplayer.setMediaItem(MediaItem.fromUri(ssUri))\n// Prepare the player.\nplayer.prepare()\n```\n\n### Java\n\n```java\n// Create a player instance.\nExoPlayer player = new ExoPlayer.Builder(context).build();\n// Set the media item to be played.\nplayer.setMediaItem(MediaItem.fromUri(ssUri));\n// Prepare the player.\nplayer.prepare();\n```\n\n\u003cbr /\u003e\n\nIf your URI doesn't end with `.ism/Manifest`, you can pass\n`MimeTypes.APPLICATION_SS` to `setMimeType` of `MediaItem.Builder` to explicitly\nindicate the type of the content.\n\nExoPlayer will automatically adapt between representations defined in the\nmanifest, taking into account both available bandwidth and device capabilities.\n\nUsing SsMediaSource\n-------------------\n\nFor more customization options, you can create a `SsMediaSource` and pass it\ndirectly to the player instead of a `MediaItem`. \n\n### Kotlin\n\n```kotlin\n// Create a data source factory.\nval dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()\n// Create a SmoothStreaming media source pointing to a manifest uri.\nval mediaSource: MediaSource =\n SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri))\n// Create a player instance.\nval player = ExoPlayer.Builder(context).build()\n// Set the media source to be played.\nplayer.setMediaSource(mediaSource)\n// Prepare the player.\nplayer.prepare()\n```\n\n### Java\n\n```java\n// Create a data source factory.\nDataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();\n// Create a SmoothStreaming media source pointing to a manifest uri.\nMediaSource mediaSource =\n new SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri));\n// Create a player instance.\nExoPlayer player = new ExoPlayer.Builder(context).build();\n// Set the media source to be played.\nplayer.setMediaSource(mediaSource);\n// Prepare the player.\nplayer.prepare();\n```\n\n\u003cbr /\u003e\n\nAccessing the manifest\n----------------------\n\nYou can retrieve the current manifest by calling `Player.getCurrentManifest`.\nFor SmoothStreaming, you should cast the returned object to `SsManifest`. The\n`onTimelineChanged` callback of `Player.Listener` is also called whenever\nthe manifest is loaded. This will happen once for on-demand content and\npossibly many times for live content. The following code snippet shows how an app\ncan do something whenever the manifest is loaded. \n\n### Kotlin\n\n```kotlin\nplayer.addListener(\n object : Player.Listener {\n override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) {\n val manifest = player.currentManifest\n if (manifest is SsManifest) {\n // Do something with the manifest.\n }\n }\n }\n)\n```\n\n### Java\n\n```java\nplayer.addListener(\n new Player.Listener() {\n @Override\n public void onTimelineChanged(\n Timeline timeline, @Player.TimelineChangeReason int reason) {\n Object manifest = player.getCurrentManifest();\n if (manifest != null) {\n SsManifest ssManifest = (SsManifest) manifest;\n // Do something with the manifest.\n }\n }\n });\n```\n\n\u003cbr /\u003e\n\nCustomizing playback\n--------------------\n\nExoPlayer provides multiple ways for you to tailor playback experience to your\napp's needs. See the [Customization page](/guide/topics/media/exoplayer/customization) for examples."]]
