يدعم 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.3.1")
رائع
implementation "androidx.media3:media3-exoplayer-dash:1.3.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 طرقًا متعدّدة لتخصيص تجربة التشغيل بما يتناسب مع احتياجات تطبيقك. يمكنك الاطّلاع على صفحة التخصيص للحصول على أمثلة.