شَرِطة

يتيح 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
CEA-708 نعم مضمّنة في FMP4 عند الإشارة إليها باستخدام واصفات إمكانية الوصول إلى SCTE
البيانات الوصفية
البيانات الوصفية لـ EMSG نعم مضمّنة في FMP4
حماية المحتوى
Widevine نعم نظام "cenc": الإصدار 19 من واجهة برمجة التطبيقات والإصدارات الأحدث، ونظام "cbcs": الإصدار 25 من واجهة برمجة التطبيقات والإصدارات الأحدث
‫PlayReady SL2000 نعم ‫Android TV، ونظام "cenc" فقط
ClearKey نعم الإصدار 21 من واجهة برمجة التطبيقات والإصدارات الأحدث، ونظام "cenc" فقط
إدراج الإعلانات
تشغيل المحتوى المتعدّد الفترات نعم
إدراج الإعلانات الموجّه من الخادم (xlinks) لا
إعلانات IMA من جهة الخادم ومن جهة العميل نعم دليل إدراج الإعلانات
تشغيل البث المباشر
تشغيل البث المباشر العادي نعم
تشغيل البث المباشر بتنسيق CMAF مع وقت استجابة سريع جدًا نعم
بيانات عميل الوسائط الشائعة (CMCD) نعم دليل التكامل مع CMCD

استخدام MediaItem

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

Kotlin

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

أنيق

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

يمكنك بعد ذلك إنشاء 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()
Dash.kt

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();
Dash.java

إذا لم ينتهِ معرّف 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()
Dash.kt

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();
Dash.java

الوصول إلى البيان

يمكنك استرداد البيان الحالي من خلال استدعاء 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.
      }
    }
  }
)
Dash.kt

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.
        }
      }
    });
Dash.java

تخصيص التشغيل

يوفّر ExoPlayer طرقًا متعدّدة لتخصيص تجربة التشغيل بما يتناسب مع احتياجات تطبيقك. راجِع صفحة التخصيص للاطّلاع على أمثلة.