يتوافق ExoPlayer مع بروتوكول HLS باستخدام تنسيقات حاويات متعدّدة. لا يحتوي الصوت يجب أيضًا دعم تنسيقات نماذج الفيديو (انظر نماذج التنسيقات للحصول على التفاصيل). أر تشجيع منتجي محتوى HLS على إنشاء مجموعات بث HLS عالية الجودة كما هو موضح هنا.
الميزة | معلومات معتمَدة | التعليقات |
---|---|---|
الحاويات | ||
MPEG-TS | نعم | |
FMP4/CMAF | نعم | |
ADTS (AAC) | نعم | |
MP3 | نعم | |
الترجمة والشرح | ||
معيار CEA-608 | نعم | |
معيار CEA-708 | نعم | |
WebVTT | نعم | |
البيانات الوصفية | ||
ID3 | نعم | |
SCTE-35 | لا | |
حماية المحتوى | ||
معيار AES-128 | نعم | |
نموذج AES-128 | لا | |
Widevine | نعم | واجهة برمجة التطبيقات +19 (مخطّط "cenc") و+25 (مخطَّط "cbcs") |
كاميرا Playجاهز SL2000 | نعم | Android TV فقط |
التحكّم في الخادم | ||
تعديلات دلتا | نعم | |
جارٍ حظر إعادة تحميل قائمة التشغيل | نعم | |
حظر تحميل تلميحات التحميل المُسبق | نعم | باستثناء نطاقات البايت ذات الأطوال غير المحددة |
تشغيل مباشر | ||
تشغيل مباشر عادي | نعم | |
بروتوكول HLS سريع الاستجابة (تفاح) | نعم | |
البث المباشر وفق بروتوكول HTTP (HLS) (المنتدى) | لا | |
بيانات عميل الوسائط الشائعة (CMCD) | نعم | دليل الدمج |
استخدام MediaItem
لتشغيل بث HLS، يجب الاعتماد على وحدة HLS.
Kotlin
implementation("androidx.media3:media3-exoplayer-hls:1.4.1")
Groovy
implementation "androidx.media3:media3-exoplayer-hls:1.4.1"
يمكنك بعد ذلك إنشاء MediaItem
لمعرّف الموارد المنتظم (URI) لقائمة تشغيل 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();
إذا كان معرّف الموارد المنتظم (URI) لا ينتهي بـ .m3u8
، يمكنك ضبط MimeTypes.APPLICATION_M3U8
.
إلى setMimeType
من MediaItem.Builder
للإشارة صراحةً إلى نوع
المحتوى.
قد يشير معرف الموارد المنتظم (URI) لعنصر الوسائط إلى قائمة تشغيل وسائط أو إلى قائمة تشغيل
قائمة التشغيل. إذا كان معرف الموارد المنتظم (URI) يشير إلى قائمة تشغيل متعددة المتغيرات تعلن عن
علامات #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
. - تقديم فترة بث مباشر طويلة دقيقة واحدة أو أكثر رائعة.