شَرِطة

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

استخدام MediaItem

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

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

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

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

// 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()

// 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.

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()

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 كلما تم تحميل البيان. ويحدث هذا الأمر مرة واحدة للمحتوى المسجَّل، وربما عدة مرات للمحتوى المباشر. يوضح مقتطف الرمز التالي كيف يمكن للتطبيق القيام بشيء ما كلما تم تحميل البيان.

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.
      }
    }
  }
)

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