ExoPlayer поддерживает SmoothStreaming с форматом контейнера FMP4. Медиапотоки должны быть демультиплексированы, то есть видео, аудио и текст должны быть определены в отдельных элементах StreamIndex в манифесте SmoothStreaming. Содержащиеся форматы образцов аудио и видео также должны поддерживаться (подробности см. в разделе «Форматы примеров» ).
Особенность | Поддерживается | Комментарии |
---|---|---|
Контейнеры | ||
ФМП4 | ДА | Только демультиплексированные потоки |
Скрытые субтитры/субтитры | ||
ТТМЛ | ДА | Встроенный в FMP4 |
Защита контента | ||
PlayReady SL2000 | ДА | Только Android-ТВ |
Живое воспроизведение | ||
Регулярное живое воспроизведение | ДА | |
Общие данные медиаклиента (CMCD) | ДА | Руководство по интеграции |
Использование Медиаитем
Чтобы воспроизводить поток SmoothStreaming, вам необходимо зависеть от модуля SmoothStreaming.
Котлин
implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.4.1")
классный
implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.4.1"
Затем вы можете создать MediaItem
для URI манифеста SmoothStreaming и передать его проигрывателю.
Котлин
// 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()
Ява
// 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
.
Котлин
// 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()
Ява
// 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
также вызывается при каждой загрузке манифеста. Это произойдет один раз для контента по запросу и, возможно, много раз для контента в реальном времени. В следующем фрагменте кода показано, как приложение может что-то делать при загрузке манифеста.
Котлин
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. } } } )
Ява
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 предоставляет вам несколько способов адаптировать воспроизведение к потребностям вашего приложения. Примеры см. на странице «Настройки» .