HLS

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

استخدام MediaItem

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

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

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

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

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

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

إذا كان معرّف الموارد المنتظم (URI) لا ينتهي بـ .m3u8، يمكنك ضبط MimeTypes.APPLICATION_M3U8 إلى setMimeType من MediaItem.Builder للإشارة بوضوح إلى نوع المحتوى.

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

استخدام HlsMediaSource

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

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

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

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

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 تحتاج إلى تنزيل قسم من الوسائط لاكتشاف هذه المقاطع الصوتية الإضافية، ويُفضَّل تضمين مقاطع الترجمة والشرح في قائمة التشغيل التي تتضمّن نُسخًا مختلفة من الصِيَغ بدلاً من ذلك.

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

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.
• تقديم فترة بث مباشر طويلة دقيقة واحدة أو أكثر رائعة.