يتوافق ExoPlayer مع DASH بتنسيقات حاويات متعددة. يجب أن تكون مجموعات بث الوسائط:
واضحة، بمعنى أنه يجب تحديد الفيديو والصوت والنص بطريقة
AdaptationSet
في بيان DASH (يُعد CEA-608 استثناءً
الموضحة في الجدول أدناه). يجب أن تكون تنسيقات نماذج الصوت والفيديو المضمّنة
(انظر
نماذج التنسيقات للحصول على التفاصيل).
الميزة | معلومات معتمَدة | التعليقات |
---|---|---|
الحاويات | ||
FMP4 | نعم | مجموعات البث بعد إزالة فلترها |
WebM | نعم | مجموعات البث بعد إزالة فلترها |
ماتروسكا | نعم | مجموعات البث بعد إزالة فلترها |
MPEG-TS | لا | ليس هناك دعم مخطط له |
الترجمة والشرح | ||
TTML | نعم | غير مضمّن أو مضمّن في FMP4 وفقًا لمعيار ISO/IEC 14496-30 |
WebVTT | نعم | غير مضمّن أو مضمّن في FMP4 وفقًا لمعيار ISO/IEC 14496-30 |
معيار CEA-608 | نعم | يتم تضمينها في FMP4 عند الإشارة إليها باستخدام أدوات وصف تسهيل الاستخدام SCTE |
معيار CEA-708 | نعم | يتم تضمينها في FMP4 عند الإشارة إليها باستخدام أدوات وصف تسهيل الاستخدام SCTE |
البيانات الوصفية | ||
البيانات الوصفية لـ EMSG | نعم | مضمّنة في FMP4 |
حماية المحتوى | ||
Widevine | نعم | "cenc" المخطط: واجهة برمجة التطبيقات 19+ "cbcs" المخطط: واجهة برمجة التطبيقات 25+ |
كاميرا Playجاهز SL2000 | نعم | Android TV ، "cenc" المخطط فقط |
مفتاح محو | نعم | واجهة برمجة التطبيقات 21+، "cenc" المخطط فقط |
تشغيل مباشر | ||
تشغيل مباشر عادي | نعم | |
وقت استجابة فائق السرعة (CMAF) | نعم | |
بيانات عميل الوسائط الشائعة (CMCD) | نعم | دليل الدمج |
استخدام MediaItem
لتشغيل بث DASH، يجب الاعتماد على وحدة DASH.
Kotlin
implementation("androidx.media3:media3-exoplayer-dash:1.4.1")
Groovy
implementation "androidx.media3:media3-exoplayer-dash:1.4.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 العديد من الطرق لتخصيص تجربة التشغيل بما يتناسب مع واحتياجاته. راجِع صفحة التخصيص للحصول على أمثلة.