يتوافق 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 فقط |
التحكّم في الخادم | ||
تعديلات دلتا | نعم | |
جارٍ حظر إعادة تحميل قائمة التشغيل | نعم | |
حظر تحميل إشارات التحميل المُسبَق | نعم | باستثناء نطاقات البايتات ذات الأطوال غير المحدّدة |
تشغيل مباشر | ||
تشغيل مباشر عادي | نعم | |
بروتوكول HLS سريع الاستجابة (تفاح) | نعم | |
البث المباشر وفق بروتوكول 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
. - يجب توفير فترة طويلة للبث المباشر. دقيقة واحدة أو أكثر رائعة.