يتوافق ExoPlayer مع DASH بتنسيقات حاويات متعددة. يجب فصل تدفقات الوسائط، ما يعني أنّه يجب تحديد الفيديو والصوت والنص في عناصر AdaptationSet
منفصلة في بيان DASH (يُستثنى من ذلك معيار CEA-608 كما هو موضّح في الجدول أدناه). يجب أن تكون تنسيقات عيّنات الصوت والفيديو المضمّنة متوافقة أيضًا (راجِع قسم تنسيقات العيّنات لمعرفة التفاصيل).
الميزة | معلومات معتمَدة | التعليقات |
---|---|---|
الحاويات | ||
FMP4 | نعم | مقاطع الفيديو التي تم فصل الصوت عن الفيديو فيها فقط |
WebM | نعم | مقاطع الفيديو التي تم فصل الصوت عن الفيديو فيها فقط |
Matroska | نعم | مقاطع الفيديو التي تم فصل الصوت عن الفيديو فيها فقط |
MPEG-TS | لا | لم يتم التخطيط لأي دعم |
الترجمة والشرح / الترجمة | ||
TTML | نعم | تنسيق RAW أو مضمّن في FMP4 وفقًا للمعيار ISO/IEC 14496-30 |
WebVTT | نعم | تنسيق RAW أو مضمّن في FMP4 وفقًا للمعيار ISO/IEC 14496-30 |
CEA-608 | نعم | مضمّنة في FMP4 عند الإشارة إليها باستخدام واصفات SCTE Accessibility |
CEA-708 | نعم | مضمّنة في FMP4 عند الإشارة إليها باستخدام واصفات SCTE Accessibility |
البيانات الوصفية | ||
البيانات الوصفية لرسائل الطوارئ | نعم | مضمّنة في FMP4 |
حماية المحتوى | ||
Widevine | نعم | مخطط "cenc": الإصدار 19 من واجهة برمجة التطبيقات أو الإصدارات الأحدث مخطط "cbcs": الإصدار 25 من واجهة برمجة التطبيقات أو الإصدارات الأحدث |
PlayReady SL2000 | نعم | Android TV، نظام "cenc" فقط |
ClearKey | نعم | الإصدار 21 من واجهة برمجة التطبيقات أو الإصدارات الأحدث، نظام "cenc" فقط |
إدراج الإعلانات | ||
تشغيل متعدد الفترات | نعم | |
إدراج الإعلانات الموجّه من الخادم (xlinks) | لا | |
إعلانات الوسائط التفاعلية من جهة الخادم ومن جهة العميل | نعم | دليل إدراج الإعلانات |
تشغيل البث المباشر | ||
التشغيل العادي للبث المباشر | نعم | |
تشغيل المحتوى المباشر بتنسيق CMAF مع وقت استجابة سريع جدًا | نعم | |
بيانات عميل الوسائط الشائعة (CMCD) | نعم | دليل دمج CMCD |
استخدام MediaItem
لتشغيل بث DASH، يجب الاعتماد على وحدة DASH.
Kotlin
implementation("androidx.media3:media3-exoplayer-dash:1.7.1")
Groovy
implementation "androidx.media3:media3-exoplayer-dash:1.7.1"
يمكنك بعد ذلك إنشاء MediaItem
لمعرّف الموارد المنتظم (URI) لملف DASH MPD وتمريره إلى المشغّل.
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();
إذا لم ينتهِ معرّف URI الخاص بك باللاحقة .mpd
، يمكنك تمرير MimeTypes.APPLICATION_MPD
إلى setMimeType
من MediaItem.Builder
للإشارة بوضوح إلى نوع المحتوى.
سيختار ExoPlayer تلقائيًا بين التمثيلات المحدّدة في ملف البيان، مع الأخذ في الاعتبار كلّ من النطاق الترددي المتاح وإمكانات الجهاز.
استخدام DashMediaSource
للحصول على المزيد من خيارات التخصيص، يمكنك إنشاء DashMediaSource
وتمريره مباشرةً إلى المشغّل بدلاً من 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();
الوصول إلى ملف البيان
يمكنك استرداد البيان الحالي من خلال طلب Player.getCurrentManifest
.
بالنسبة إلى DASH، يجب تحويل العنصر الذي تم عرضه إلى DashManifest
. يتم أيضًا استدعاء
onTimelineChanged
دالّة ردّ الاتصال الخاصة بـ Player.Listener
كلما تم تحميل البيان. سيحدث ذلك مرة واحدة للمحتوى المتاح عند الطلب، وربما عدة مرات للمحتوى المباشر. يوضّح مقتطف الرمز البرمجي التالي كيف يمكن لتطبيق تنفيذ إجراء معيّن عند تحميل ملف البيان.
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. } } });
تخصيص التشغيل
توفّر ExoPlayer طرقًا متعدّدة لتخصيص تجربة التشغيل حسب احتياجات تطبيقك. يمكنك الاطّلاع على صفحة التخصيص للحصول على أمثلة.