خط تیره
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
ExoPlayer از DASH با چندین فرمت کانتینر پشتیبانی می کند. جریانهای رسانه باید دموکس شوند، به این معنی که ویدیو، صدا و متن باید در عناصر AdaptationSet
مجزا در مانیفست DASH تعریف شوند (CEA-608 یک استثنا است که در جدول زیر توضیح داده شده است). فرمتهای نمونه صوتی و تصویری موجود نیز باید پشتیبانی شوند (برای جزئیات به بخش قالبهای نمونه مراجعه کنید).
ویژگی | پشتیبانی می شود | نظرات |
---|
ظروف | | |
FMP4 | بله | فقط جریان های دموکس |
WebM | بله | فقط جریان های دموکس |
ماتروسکا | بله | فقط جریان های دموکس |
MPEG-TS | نه | هیچ حمایتی برنامه ریزی نشده است |
زیرنویس / زیرنویس بسته | | |
TTML | بله | خام، یا تعبیه شده در FMP4 طبق ISO/IEC 14496-30 |
WebVTT | بله | خام، یا تعبیه شده در FMP4 طبق ISO/IEC 14496-30 |
CEA-608 | بله | هنگامی که با استفاده از توصیفگرهای دسترسی SCTE سیگنال داده می شود، در FMP4 تعبیه شده است |
CEA-708 | بله | هنگامی که با استفاده از توصیفگرهای دسترسی SCTE سیگنال داده می شود، در FMP4 تعبیه شده است |
فراداده | | |
فراداده EMSG | بله | تعبیه شده در FMP4 |
حفاظت از محتوا | | |
وایدواین | بله | طرح "cenc": API 19+; طرح "cbcs": API 25+ |
PlayReady SL2000 | بله | Android TV، فقط طرح "cenc". |
ClearKey | بله | API 21+، فقط طرح "cenc". |
درج آگهی | | |
پخش چند دوره ای | بله | |
درج آگهی با هدایت سرور (xlinks) | نه | |
تبلیغات سمت سرور و سمت سرویس گیرنده IMA | بله | راهنمای درج آگهی |
پخش زنده | | |
پخش زنده منظم | بله | |
پخش زنده CMAF با تاخیر بسیار کم | بله | |
داده های مشترک رسانه مشتری (CMCD) | بله | راهنمای ادغام CMCD |
برای پخش جریان DASH، باید به ماژول DASH وابسته باشید.
کاتلین
implementation("androidx.media3:media3-exoplayer-dash:1.8.0")
شیار
implementation "androidx.media3:media3-exoplayer-dash:1.8.0"
سپس می توانید یک MediaItem
برای یک DASH MPD URI ایجاد کنید و آن را به پخش کننده ارسال کنید.
کاتلین
// 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()
جاوا
// 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();
اگر URI شما به .mpd
ختم نمی شود، می توانید MimeTypes.APPLICATION_MPD
را به setMimeType
MediaItem.Builder
ارسال کنید تا نوع محتوا را به صراحت نشان دهید.
ExoPlayer به طور خودکار بین نمایش های تعریف شده در مانیفست با در نظر گرفتن پهنای باند موجود و قابلیت های دستگاه سازگار می شود.
برای گزینههای سفارشیسازی بیشتر، میتوانید یک DashMediaSource
ایجاد کنید و آن را بهجای MediaItem
مستقیماً به پخشکننده ارسال کنید.
کاتلین
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()
جاوا
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();
دسترسی به مانیفست
میتوانید با فراخوانی Player.getCurrentManifest
مانیفست فعلی را بازیابی کنید. برای DASH باید شی برگشتی را به DashManifest
ارسال کنید. پاسخ تماس onTimelineChanged
Player.Listener
نیز هر زمان که مانیفست بارگیری می شود فراخوانی می شود. این یک بار برای محتوای درخواستی و احتمالاً بارها برای محتوای زنده اتفاق می افتد. قطعه کد زیر نشان می دهد که چگونه یک برنامه می تواند هر زمان که مانیفست بارگیری می شود کاری انجام دهد.
کاتلین
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.
}
}
}
)
جاوا
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.
}
}
});
سفارشی کردن پخش
ExoPlayer راه های متعددی را برای شما فراهم می کند تا تجربه پخش را مطابق با نیازهای برنامه خود تنظیم کنید. برای نمونه به صفحه سفارشی سازی مراجعه کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# DASH\n\nExoPlayer supports DASH with multiple container formats. Media streams must be\ndemuxed, meaning that video, audio, and text must be defined in distinct\n`AdaptationSet` elements in the DASH manifest (CEA-608 is an exception as\ndescribed in the table below). The contained audio and video sample formats must\nalso 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| WebM | YES | Demuxed streams only |\n| Matroska | YES | Demuxed streams only |\n| MPEG-TS | NO | No support planned |\n| **Closed captions /** **subtitles** | | |\n| TTML | YES | Raw, or embedded in FMP4 according to ISO/IEC 14496-30 |\n| WebVTT | YES | Raw, or embedded in FMP4 according to ISO/IEC 14496-30 |\n| CEA-608 | YES | Embedded in FMP4 when signalled using SCTE Accessibility descriptors |\n| CEA-708 | YES | Embedded in FMP4 when signalled using SCTE Accessibility descriptors |\n| **Metadata** | | |\n| EMSG metadata | YES | Embedded in FMP4 |\n| **Content protection** | | |\n| Widevine | YES | \"cenc\" scheme: API 19+; \"cbcs\" scheme: API 25+ |\n| PlayReady SL2000 | YES | Android TV, \"cenc\" scheme only |\n| ClearKey | YES | API 21+, \"cenc\" scheme only |\n| **Ad insertion** | | |\n| Multi-period playback | YES | |\n| Server-guided ad insertion (xlinks) | NO | |\n| IMA server-side and client-side ads | YES | [Ad insertion guide](/media/media3/exoplayer/ad-insertion) |\n| **Live playback** | | |\n| Regular live playback | YES | |\n| Ultra low-latency CMAF live playback | YES | |\n| **Common Media Client Data** **(CMCD)** | YES | [CMCD integration guide](/media/media3/exoplayer/cmcd) |\n\nUsing MediaItem\n---------------\n\nTo play a DASH stream, you need to depend on the DASH module. \n\n### Kotlin\n\n```kotlin\nimplementation(\"androidx.media3:media3-exoplayer-dash:1.8.0\")\n```\n\n### Groovy\n\n```groovy\nimplementation \"androidx.media3:media3-exoplayer-dash:1.8.0\"\n```\n\nYou can then create a `MediaItem` for a DASH MPD URI and pass it to 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(dashUri))\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(dashUri));\n// Prepare the player.\nplayer.prepare();\n```\n\n\u003cbr /\u003e\n\nIf your URI doesn't end with `.mpd`, you can pass `MimeTypes.APPLICATION_MPD`\nto `setMimeType` of `MediaItem.Builder` to explicitly indicate the type of the\ncontent.\n\nExoPlayer will automatically adapt between representations defined in the\nmanifest, taking into account both available bandwidth and device capabilities.\n\nUsing DashMediaSource\n---------------------\n\nFor more customization options, you can create a `DashMediaSource` and pass it\ndirectly to the player instead of a `MediaItem`. \n\n### Kotlin\n\n```kotlin\nval dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()\n// Create a dash media source pointing to a dash manifest uri.\nval mediaSource: MediaSource =\n DashMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(dashUri))\n// Create a player instance which gets an adaptive track selector by default.\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\nDataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();\n// Create a dash media source pointing to a dash manifest uri.\nMediaSource mediaSource =\n new DashMediaSource.Factory(dataSourceFactory)\n .createMediaSource(MediaItem.fromUri(dashUri));\n// Create a player instance which gets an adaptive track selector by default.\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 DASH you should cast the returned object to `DashManifest`. The\n`onTimelineChanged` callback of `Player.Listener` is also called whenever\nthe manifest is loaded. This will happen once for a 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 DashManifest) {\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 DashManifest dashManifest = (DashManifest) 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."]]