ExoPlayer поддерживает DASH с несколькими форматами контейнеров. Медиапотоки должны быть демультиплексированы, то есть видео, аудио и текст должны быть определены в отдельных элементах AdaptationSet
в манифесте DASH (CEA-608 является исключением, как описано в таблице ниже). Содержащиеся форматы образцов аудио и видео также должны поддерживаться (подробности см. в разделе форматов образцов ).
Особенность | Поддерживается | Комментарии |
---|---|---|
Контейнеры | ||
ФМП4 | ДА | Только демультиплексированные потоки |
ВебМ | ДА | Только демультиплексированные потоки |
Матроска | ДА | Только демультиплексированные потоки |
MPEG-TS | НЕТ | Поддержка не планируется |
Скрытые титры / субтитры | ||
ТТМЛ | ДА | Необработанный или встроенный в FMP4 в соответствии с ISO/IEC 14496-30 |
WebVTT | ДА | Необработанный или встроенный в FMP4 в соответствии с ISO/IEC 14496-30 |
СЕА-608 | ДА | Встроено в FMP4 при получении сигнала с использованием дескрипторов доступности SCTE |
СЕА-708 | ДА | Встроено в FMP4 при получении сигнала с использованием дескрипторов доступности SCTE |
Метаданные | ||
Метаданные EMSG | ДА | Встроено в FMP4 |
Защита контента | ||
Широкая лоза | ДА | Схема "cenc": API 19+; Схема "cbcs": API 25+ |
PlayReady SL2000 | ДА | Android TV, только схема "cenc" |
ClearKey | ДА | API 21+, только схема "cenc" |
Вставка рекламы | ||
Многопериодное воспроизведение | ДА | |
Вставка рекламы под управлением сервера (xlinks) | НЕТ | |
Реклама IMA на стороне сервера и клиента | ДА | Руководство по вставке рекламы |
Живое воспроизведение | ||
Регулярное живое воспроизведение | ДА | |
Воспроизведение в реальном времени CMAF с ультранизкой задержкой | ДА | |
Общие данные клиентов медиа (CMCD) | ДА | Руководство по интеграции CMCD |
Использование MediaItem
Для воспроизведения потока DASH вам необходим модуль DASH.
Котлин
implementation("androidx.media3:media3-exoplayer-dash:1.7.1")
Круто
implementation "androidx.media3:media3-exoplayer-dash:1.7.1"
Затем вы можете создать MediaItem
для URI DASH MPD и передать его проигрывателю.
Котлин
// Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(dashUri)) // 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(dashUri)); // Prepare the player. player.prepare();
Если ваш URI не заканчивается на .mpd
, вы можете передать MimeTypes.APPLICATION_MPD
в setMimeType
MediaItem.Builder
, чтобы явно указать тип содержимого.
ExoPlayer автоматически адаптируется между представлениями, определенными в манифесте, принимая во внимание как доступную пропускную способность, так и возможности устройства.
Использование DashMediaSource
Для получения дополнительных возможностей настройки вы можете создать DashMediaSource
и передать его напрямую проигрывателю вместо MediaItem
.
Котлин
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory() // Create a dash media source pointing to a dash manifest uri. val mediaSource: MediaSource = DashMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(dashUri)) // Create a player instance which gets an adaptive track selector by default. val player = ExoPlayer.Builder(context).build() // Set the media source to be played. player.setMediaSource(mediaSource) // Prepare the player. player.prepare()
Ява
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory(); // Create a dash media source pointing to a dash manifest uri. MediaSource mediaSource = new DashMediaSource.Factory(dataSourceFactory) .createMediaSource(MediaItem.fromUri(dashUri)); // Create a player instance which gets an adaptive track selector by default. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the media source to be played. player.setMediaSource(mediaSource); // Prepare the player. player.prepare();
Доступ к манифесту
Вы можете получить текущий манифест, вызвав Player.getCurrentManifest
. Для DASH вы должны привести возвращаемый объект к DashManifest
. Обратный вызов onTimelineChanged
Player.Listener
также вызывается всякий раз, когда загружается манифест. Это произойдет один раз для контента по запросу и, возможно, много раз для контента в реальном времени. Следующий фрагмент кода показывает, как приложение может что-то делать всякий раз, когда загружается манифест.
Котлин
player.addListener( object : Player.Listener { override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) { val manifest = player.currentManifest if (manifest is DashManifest) { // 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) { DashManifest dashManifest = (DashManifest) manifest; // Do something with the manifest. } } });
Настройка воспроизведения
ExoPlayer предоставляет несколько способов настройки воспроизведения под нужды вашего приложения. Примеры см. на странице «Настройка» .