SmoothStreaming
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
ExoPlayer از SmoothStreaming با فرمت ظرف FMP4 پشتیبانی می کند. جریانهای رسانه باید دموکس شوند، به این معنی که ویدیو، صدا و متن باید در عناصر StreamIndex مجزا در مانیفست SmoothStreaming تعریف شوند. فرمتهای نمونه صوتی و تصویری موجود نیز باید پشتیبانی شوند (برای جزئیات به بخش قالبهای نمونه مراجعه کنید).
ویژگی | پشتیبانی می شود | نظرات |
---|
ظروف | | |
FMP4 | بله | فقط جریان های دیموکس |
زیرنویسها/زیرنویسهای بسته | | |
TTML | بله | تعبیه شده در FMP4 |
حفاظت از محتوا | | |
PlayReady SL2000 | بله | فقط Android TV |
پخش زنده | | |
پخش زنده منظم | بله | |
داده های مشترک رسانه مشتری (CMCD) | بله | راهنمای ادغام |
برای پخش یک جریان SmoothStreaming، باید به ماژول SmoothStreaming وابسته باشید.
کاتلین
implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.8.0")
شیار
implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.8.0"
سپس می توانید یک MediaItem
برای یک URI مانیفست SmoothStreaming ایجاد کنید و آن را به پخش کننده ارسال کنید.
کاتلین
// 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()
جاوا
// 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();
اگر URI شما به .ism/Manifest
ختم نمی شود، می توانید MimeTypes.APPLICATION_SS
به setMimeType
از MediaItem.Builder
منتقل کنید تا نوع محتوا را به صراحت نشان دهد.
ExoPlayer به طور خودکار بین نمایش های تعریف شده در مانیفست با در نظر گرفتن پهنای باند موجود و قابلیت های دستگاه سازگار می شود.
برای گزینههای سفارشیسازی بیشتر، میتوانید یک SsMediaSource
ایجاد کنید و آن را بهجای MediaItem
مستقیماً به پخشکننده ارسال کنید.
کاتلین
// 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()
جاوا
// 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();
دسترسی به مانیفست
میتوانید با فراخوانی Player.getCurrentManifest
مانیفست فعلی را بازیابی کنید. برای SmoothStreaming، باید شیء برگشتی را به SsManifest
ارسال کنید. پاسخ تماس onTimelineChanged
Player.Listener
نیز هر زمان که مانیفست بارگیری می شود فراخوانی می شود. این یک بار برای محتوای درخواستی و احتمالاً بارها برای محتوای زنده اتفاق می افتد. قطعه کد زیر نشان می دهد که چگونه یک برنامه می تواند هر زمان که مانیفست بارگیری می شود کاری انجام دهد.
کاتلین
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.
}
}
}
)
جاوا
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.
}
}
});
سفارشی کردن پخش
ExoPlayer راه های متعددی را برای شما فراهم می کند تا تجربه پخش را مطابق با نیازهای برنامه خود تنظیم کنید. برای نمونه به صفحه سفارشی سازی مراجعه کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]