HLS

يتوافق ExoPlayer مع HLS باستخدام تنسيقات حاويات متعددة. يجب أيضًا أن تكون تنسيقات عيّنات الصوت والفيديو المضمّنة متوافقة (اطّلِع على قسم تنسيقات العيّنات لمعرفة التفاصيل). ننصح بشدة صنّاع المحتوى الذين يستخدمون بروتوكول HLS بإنشاء أحداث بث عالية الجودة باستخدام هذا البروتوكول، كما هو موضّح هنا.

الميزة	معلومات معتمَدة	التعليقات
الحاويات
‫MPEG-TS	نعم
‫FMP4/CMAF	نعم
ADTS (AAC)	نعم
MP3	نعم
الترجمة والشرح
‫CEA-608	نعم
‫CEA-708	نعم
WebVTT	نعم
البيانات الوصفية
رقم التعريف 3	نعم
SCTE-35	لا
حماية المحتوى
‫AES-128	نعم
نموذج AES-128	لا
Widevine	نعم	الإصدار 19 من واجهة برمجة التطبيقات والإصدارات الأحدث ("مخطط cenc") والإصدار 25 من واجهة برمجة التطبيقات والإصدارات الأحدث ("مخطط cbcs")
‫PlayReady SL2000	نعم	Android TV فقط
التحكّم في الخادم
تحديثات دلتا	نعم
حظر إعادة تحميل قائمة التشغيل	نعم
حظر تحميل إشارات التحميل المُسبَق	نعم	باستثناء نطاقات البايتات ذات الأطوال غير المحدّدة
التشغيل المباشر
التشغيل المباشر العادي	نعم
البث المباشر وفق بروتوكول HTTP (HLS) بوقت استجابة منخفض (Apple)	نعم
البث المباشر وفق بروتوكول HTTP (HLS) بوقت استجابة منخفض (المنتدى)	لا
بيانات العميل المشترَكة للوسائط (CMCD)	نعم	دليل الدمج

استخدام MediaItem

لتشغيل بث مباشر وفق بروتوكول HLS، عليك الاعتماد على وحدة HLS.

Kotlin

implementation("androidx.media3:media3-exoplayer-hls:1.4.1")

رائع

implementation "androidx.media3:media3-exoplayer-hls:1.4.1"

يمكنك بعد ذلك إنشاء MediaItem لمعرّف الموارد المنتظم لقائمة تشغيل HLS ونقله إلى المشغّل.

Kotlin

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

إذا لم ينتهِ عنوان URL بـ .m3u8، يمكنك تمرير MimeTypes.APPLICATION_M3U8 إلى setMimeType من MediaItem.Builder للإشارة صراحةً إلى نوع المحتوى.

قد يشير معرّف الموارد المنتظم لعنصر الوسائط إلى قائمة تشغيل وسائط أو قائمة تشغيل متعددة الأشكال. إذا كان معرّف الموارد المطلق يشير إلى قائمة تشغيل متعددة الصيغ تُعرِض علامات #EXT-X-STREAM-INF متعددة، سيتكيّف ExoPlayer تلقائيًا بين الصيغ، مع الأخذ في الاعتبار كلاً من معدل نقل البيانات المتاح وإمكانات الجهاز.

استخدام HlsMediaSource

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

Kotlin

// Create a data source factory.
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a HLS media source pointing to a playlist uri.
val hlsMediaSource =
  HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri))
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the HLS media source as the playlist with a single media item.
player.setMediaSource(hlsMediaSource)
// Prepare the player.
player.prepare()

Java

// Create a data source factory.
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a HLS media source pointing to a playlist uri.
HlsMediaSource hlsMediaSource =
    new HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri));
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the HLS media source as the playlist with a single media item.
player.setMediaSource(hlsMediaSource);
// Prepare the player.
player.prepare();

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

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

Kotlin

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

تخصيص عملية التشغيل

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

إيقاف ميزة "الإعداد بدون أجزاء"

سيستخدم ExoPlayer الإعداد بدون أجزاء تلقائيًا. وهذا يعني أنّ ExoPlayer لن يستخدم سوى المعلومات الواردة في قائمة التشغيل التي تتضمّن صيغًا متعددة لإعداد البث، وذلك إذا كانت علامات #EXT-X-STREAM-INF تحتوي على السمة CODECS.

قد تحتاج إلى إيقاف هذه الميزة إذا كانت مقاطع الوسائط تحتوي على مقاطع ملف ملتحم لترجمة الأفلام لم يتم الإعلان عنها في قائمة التشغيل المتعدّدة الصيغ باستخدام علامة #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS. بخلاف ذلك، لن يتم رصد مقاطع الترجمة والشرح هذه وتشغيلها. يمكنك إيقاف ميزة "الإعداد بدون أجزاء" في HlsMediaSource.Factory كما هو موضّح في المقتطف التالي. يُرجى العِلم أنّه سيزيد ذلك من وقت بدء التشغيل لأنّ ExoPlayer يحتاج إلى تنزيل مقطع وسائط لتحديد هذه المقاطع الصوتية الإضافية، ويُفضّل الإفصاح عن مقاطع الترجمة والشرح في قائمة التشغيل المتعدّدة الصيغ بدلاً من ذلك.

Kotlin

val hlsMediaSource =
  HlsMediaSource.Factory(dataSourceFactory)
    .setAllowChunklessPreparation(false)
    .createMediaSource(MediaItem.fromUri(hlsUri))

Java

HlsMediaSource hlsMediaSource =
    new HlsMediaSource.Factory(dataSourceFactory)
        .setAllowChunklessPreparation(false)
        .createMediaSource(MediaItem.fromUri(hlsUri));

إنشاء محتوى HLS عالي الجودة

للاستفادة إلى أقصى حد من ExoPlayer، هناك إرشادات معيّنة يمكنك اتّباعها لتحسين محتوى HLS. لمزيد من المعلومات، يُرجى الاطّلاع على المشاركة على Medium حول تشغيل HLS في ExoPlayer. في ما يلي النقاط الرئيسية:

• استخدِم مدّات دقيقة للمقاطع.
• استخدِم بثًا متّصلاً للوسائط، وتجنَّب التغييرات في بنية الوسائط على مستوى المقاطع.
• استخدِم العلامة #EXT-X-INDEPENDENT-SEGMENTS.
• يُفضَّل استخدام أحداث البث التي تم فك ترميزها بدلاً من الملفات التي تتضمّن الفيديو والصوت معًا.
• أدرِج كل المعلومات التي يمكنك تضمينها في قائمة التشغيل التي تتضمّن خيارات متعددة.

تنطبق الإرشادات التالية على أحداث البث المباشر تحديدًا:

• استخدِم العلامة #EXT-X-PROGRAM-DATE-TIME.
• استخدِم العلامة #EXT-X-DISCONTINUITY-SEQUENCE.
• يجب توفير فترة طويلة للبث المباشر. من الجيد أن تبلغ مدّة المراجعة دقيقة واحدة أو أكثر.