البث السلس

يتوافق ExoPlayer مع SmoothStreaming مع تنسيق الحاوية FMP4. يجب إزالة تمويه مصادر الوسائط، أي أنّه يجب تحديد الفيديو والصوت والنص في عناصر StreamIndexs مختلفة في بيان SmoothStreaming. يجب أيضًا توفير تنسيقات الصوت والفيديو المضمّنة في نماذج الصوت (راجِع قسم عيّنات التنسيقات للاطّلاع على التفاصيل).

الميزة	معلومات معتمَدة	التعليقات
الحاويات
قاعدة بيانات FMP4	نعم	أحداث البث المباشر فقط
الترجمة المغلقة
TTML	نعم	مُضمَّنة في FMP4
حماية المحتوى
Playجاهز SL2000	نعم	Android TV فقط
التشغيل المباشر
تشغيل مباشر عادي	نعم
بيانات برنامج الوسائط الشائعة (CMCD)	نعم	دليل الدمج

استخدام MediaItem

لتشغيل ساحة مشاركات SmoothStreaming، تحتاج إلى الاعتماد على وحدة SmoothStreaming.

Kotlin

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

رائع

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

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

Kotlin

// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(ssUri))
// 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(ssUri));
// Prepare the player.
player.prepare();

إذا كان معرّف الموارد المنتظم (URI) لا ينتهي بـ .ism/Manifest، يمكنك تمرير MimeTypes.APPLICATION_SS إلى setMimeType من MediaItem.Builder للإشارة بشكل صريح إلى نوع المحتوى.

وسيتكيف ExoPlayer تلقائيًا بين العروض المحددة في البيان، مع مراعاة كل من معدل نقل البيانات المتاح وإمكانات الجهاز.

استخدام SsMediaSource

لمزيد من خيارات التخصيص، يمكنك إنشاء SsMediaSource وإرساله مباشرةً إلى المشغّل بدلاً من MediaItem.

Kotlin

// Create a data source factory.
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a SmoothStreaming media source pointing to a manifest uri.
val mediaSource: MediaSource =
  SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri))
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media source to be played.
player.setMediaSource(mediaSource)
// Prepare the player.
player.prepare()

Java

// Create a data source factory.
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a SmoothStreaming media source pointing to a manifest uri.
MediaSource mediaSource =
    new SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri));
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media source to be played.
player.setMediaSource(mediaSource);
// Prepare the player.
player.prepare();

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

يمكنك استرداد البيان الحالي من خلال استدعاء Player.getCurrentManifest. بالنسبة إلى SmoothStreaming، يجب تحويل الكائن المعروض إلى SsManifest. ويتم أيضًا استدعاء استدعاء onTimelineChanged لـ Player.Listener كلما تم تحميل البيان. ويحدث ذلك مرة واحدة للمحتوى المسجّل وربما عدة مرات للمحتوى المباشر. يوضح مقتطف الرمز التالي كيف يمكن لتطبيق ما القيام بشيء ما كلما تم تحميل البيان.

Kotlin

player.addListener(
  object : Player.Listener {
    override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) {
      val manifest = player.currentManifest
      if (manifest is SsManifest) {
        // 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) {
          SsManifest ssManifest = (SsManifest) manifest;
          // Do something with the manifest.
        }
      }
    });

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

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