شَرِطة

يتوافق 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.8.0")

Groovy

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

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