يتوافق 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 طرقًا متعدّدة لتخصيص تجربة التشغيل بما يتناسب مع احتياجات تطبيقك. يمكنك الاطّلاع على صفحة التخصيص للحصول على أمثلة.