شَرِطة

يتيح ExoPlayer استخدام DASH مع تنسيقات حاويات متعددة. يجب إلغاء تعدد إرسال مجموعات بث الوسائط، ما يعني أنّه يجب تحديد الفيديو والصوت والنص في عناصر AdaptationSet منفصلة في بيان DASH (يُستثنى من ذلك CEA-608 كما هو موضّح في الجدول أدناه). يجب أيضًا أن تكون تنسيقات عيّنات الصوت والفيديو المضمّنة متوافقة (يُرجى الاطّلاع على قسم تنسيقات العيّنات للحصول على التفاصيل).

الميزة متاح التعليقات
الحاويات
FMP4 نعم أحداث البث المباشر المنفصلة فقط
WebM نعم أحداث البث المباشر المنفصلة فقط
Matroska نعم أحداث البث المباشر المنفصلة فقط
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 من واجهة برمجة التطبيقات أو الإصدارات الأحدث
PlayReady SL2000 نعم ‫Android TV، نظام "cenc" فقط
ClearKey نعم ‫API 21+‎، نظام "cenc" فقط
إدراج الإعلانات
التشغيل المتعدّد الفترات نعم
إدراج الإعلانات بتوجيه من الخادم (xlinks) لا
إعلانات IMA من جهة الخادم ومن جهة العميل نعم دليل إدراج الإعلانات
تشغيل البث المباشر
التشغيل العادي للبث المباشر نعم
تشغيل البث المباشر بتنسيق CMAF مع وقت استجابة فائق السرعة نعم
بيانات عميل الوسائط الشائعة (CMCD) نعم دليل دمج CMCD

استخدام MediaItem

لتشغيل بث DASH، عليك الاعتماد على وحدة DASH.

Kotlin

implementation("androidx.media3:media3-exoplayer-dash:1.11.1")

أنيق

implementation "androidx.media3:media3-exoplayer-dash:1.11.1"

يمكنك بعد ذلك إنشاء MediaItem لعنوان URI لملف MPD بتنسيق DASH وتمريره إلى المشغّل.

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,
      @Player.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 طرقًا متعددة لتخصيص تجربة التشغيل بما يتناسب مع احتياجات تطبيقك. يمكنك الاطّلاع على صفحة التخصيص للحصول على أمثلة.