ЗОЖ

ExoPlayer поддерживает HLS с несколькими форматами контейнеров. Содержащиеся форматы аудио- и видеообразцов также должны поддерживаться (см. раздел форматов образцов для получения подробной информации). Мы настоятельно рекомендуем производителям HLS-контента создавать высококачественные потоки HLS, как описано в этой записи блога .

Особенность Поддерживается Комментарии
Контейнеры
MPEG-TS ДА
FMP4/CMAF ДА
АДТС (ААС) ДА
МП3 ДА
Скрытые титры / субтитры
СЕА-608 ДА
СЕА-708 ДА
WebVTT ДА
Метаданные
ID3 ДА
СКТЕ-35 НЕТ
Защита контента
АЕС-128 ДА
Образец АЕС-128 НЕТ
Широкая лоза ДА API 19+ (схема «cenc») и 25+ (схема «cbcs»)
PlayReady SL2000 ДА только Android TV
Управление сервером
Дельта-обновления ДА
Блокировка перезагрузки плейлиста ДА
Блокировка загрузки подсказок предварительной загрузки ДА За исключением байтовых диапазонов с неопределенной длиной.
Вставка рекламы
Вставка рекламы под управлением сервера (межстраничные объявления) Частично Только VOD с X-ASSET-URI . Прямые трансляции и X-ASSET-LIST будут добавлены позже.
Реклама IMA на стороне сервера и клиента ДА Руководство по вставке рекламы
Живое воспроизведение
Регулярное живое воспроизведение ДА
HLS с низкой задержкой (Apple) ДА
HLS с низкой задержкой (Сообщество) НЕТ
Общие данные клиента медиа CMCD ДА Руководство по интеграции CMCD

Использование MediaItem

Для воспроизведения потока HLS вам необходим модуль HLS.

Котлин

implementation("androidx.media3:media3-exoplayer-hls:1.7.1")

Круто

implementation "androidx.media3:media3-exoplayer-hls:1.7.1"

Затем вы можете создать MediaItem для URI плейлиста HLS и передать его проигрывателю.

Котлин

// 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()

Ява

// 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 .

Котлин

// 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()

Ява

// 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 также вызывается всякий раз, когда загружается манифест. Это произойдет один раз для контента по запросу и, возможно, много раз для контента в реальном времени. Следующий фрагмент кода показывает, как приложение может что-то делать всякий раз, когда загружается манифест.

Котлин

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.
      }
    }
  }
)

Ява

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.
        }
      }
    });

Воспроизведение потоков HLS с вставками

Спецификация HLS определяет вставки HLS, которые можно использовать для включения вставочной информации в список воспроизведения мультимедиа. ExoPlayer по умолчанию игнорирует эти вставки. Поддержку можно добавить с помощью HlsInterstitialsAdsLoader . Мы не поддерживаем все функции спецификации с самого начала. Если вам не хватает поддержки для вашего потока, сообщите нам об этом , отправив сообщение о проблеме на GitHub и отправив нам URI вашего потока, чтобы мы могли добавить поддержку для вашего потока.

Используйте MediaItem с API плейлиста

Наиболее удобный способ воспроизведения потоков HLS с вставками — создание экземпляра ExoPlayer с HlsInterstitialsAdsLoader.AdsMediaSourceFactory . Это позволяет использовать API плейлистов на основе MediaItem интерфейса Player для воспроизведения вставок HLS.

MediaSource.Factory ExoPlayer можно внедрить в конструктор при создании экземпляра проигрывателя:

Котлин

hlsInterstitialsAdsLoader = HlsInterstitialsAdsLoader(context)
// Create a MediaSource.Factory for HLS streams with interstitials.
var hlsMediaSourceFactory =
  HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
    hlsInterstitialsAdsLoader,
    playerView,
    DefaultMediaSourceFactory(context),
  )

// Build player with interstitials media source factory
player =
  ExoPlayer.Builder(context)
    .setMediaSourceFactory(hlsMediaSourceFactory)
    .build()

// Set the player on the ads loader.
hlsInterstitialsAdsLoader.setPlayer(player)
playerView.setPlayer(player)

Ява

hlsInterstitialsAdsLoader = new HlsInterstitialsAdsLoader(context);
// Create a MediaSource.Factory for HLS streams with interstitials.
MediaSource.Factory hlsMediaSourceFactory =
      new HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
          hlsInterstitialsAdsLoader, playerView, new DefaultMediaSourceFactory(context));

// Build player with interstitials media source factory
player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(hlsMediaSourceFactory)
        .build();

// Set the player on the ads loader.
hlsInterstitialsAdsLoader.setPlayer(player);
playerView.setPlayer(player);

При такой настройке проигрывателя воспроизведение межстраничных объявлений HLS сводится к настройке элемента мультимедиа с помощью AdsConfiguration на проигрывателе:

Котлин

player.setMediaItem(
  MediaItem.Builder()
    .setUri("https://www.example.com/media.m3u8")
    .setAdsConfiguration(
      AdsConfiguration.Builder(Uri.parse("hls://interstitials"))
        .setAdsId("ad-tag-0") // must be unique within playlist
        .build())
    .build())

player.prepare();
player.play();

Ява

player.setMediaItem(
    new MediaItem.Builder()
        .setUri("https://www.example.com/media.m3u8")
        .setAdsConfiguration(
            new AdsConfiguration.Builder(Uri.parse("hls://interstitials"))
                .setAdsId("ad-tag-0") // must be unique within playlist
                .build())
        .build());
player.prepare();
player.play();

Используйте API на основе медиа-источника

В качестве альтернативы, экземпляр ExoPlayer может быть создан без переопределения фабрики источников медиа по умолчанию. Для поддержки вставок приложение может затем использовать HlsInterstitialsAdsLoader.AdsMediaSourceFactory напрямую для создания MediaSource и предоставления его ExoPlayer с помощью API плейлиста на основе источника медиа:

Котлин

hlsInterstitialsAdsLoader = HlsInterstitialsAdsLoader(context)
// Create a MediaSource.Factory for HLS streams with interstitials.
var hlsMediaSourceFactory =
  HlsInterstitialsAdsLoader.AdsMediaSourceFactory(hlsInterstitialsAdsLoader, playerView, context)

// Build player with default media source factory.
player = new ExoPlayer.Builder(context).build();

// Create an media source from an HLS media item with ads configuration.
val mediaSource =
  hlsMediaSourceFactory.createMediaSource(
    MediaItem.Builder()
      .setUri("https://www.example.com/media.m3u8")
      .setAdsConfiguration(
        MediaItem.AdsConfiguration.Builder(Uri.parse("hls://interstitials"))
          .setAdsId("ad-tag-0")
          .build()
      )
      .build()
  )

// Set the media source on the player.
player.setMediaSource(mediaSource)
player.prepare()
player.play()

Ява

HlsInterstitialsAdsLoader hlsInterstitialsAdsLoader = new HlsInterstitialsAdsLoader(context);
// Create a MediaSource.Factory for HLS streams with interstitials.
MediaSource.Factory hlsMediaSourceFactory =
    new HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
      hlsInterstitialsAdsLoader, playerView, context);

// Build player with default media source factory.
player = new ExoPlayer.Builder(context).build();

// Create an media source from an HLS media item with ads configuration.
MediaSource mediaSource =
    hlsMediaSourceFactory.createMediaSource(
      new MediaItem.Builder()
        .setUri("https://www.example.com/media.m3u8")
        .setAdsConfiguration(
            new MediaItem.AdsConfiguration.Builder(Uri.parse("hls://interstitials"))
                .setAdsId("ad-tag-0")
                .build())
        .build());

// Set the media source on the player.
exoPlayer.setMediaSource(mediaSource);
exoPlayer.prepare();
exoPlayer.play();

Слушайте рекламные события

Listener может быть добавлен в HlsInterstitialsAdsLoader для отслеживания событий, касающихся изменений статуса воспроизведения межстраничных объявлений HLS. Это позволяет приложению или SDK отслеживать воспроизведение рекламы, загрузку списков активов, подготовку источников рекламных медиа или обнаруживать ошибки загрузки списков активов и подготовки рекламы. Кроме того, метаданные, выдаваемые источниками рекламных медиа, могут быть получены для детальной проверки воспроизведения рекламы или для отслеживания хода воспроизведения рекламы.

Котлин

class AdsLoaderListener : HlsInterstitialsAdsLoader.Listener {

  override fun onStart(mediaItem: MediaItem, adsId: Any, adViewProvider: AdViewProvider) {
    // Do something when HLS media item with interstitials is started.
  }

  override fun onMetadata(
    mediaItem: MediaItem,
    adsId: Any,
    adGroupIndex: Int,
    adIndexInAdGroup: Int,
    metadata: Metadata,
  ) {
    // Do something with metadata that is emitted by the ad media source of the given ad.
  }

  override fun onAdCompleted(
    mediaItem: MediaItem,
    adsId: Any,
    adGroupIndex: Int,
    adIndexInAdGroup: Int,
  ) {
    // Do something when ad completed playback.
  }

  // ... See JavaDoc for further callbacks of HlsInterstitialsAdsLoader.Listener.

  override fun onStop(mediaItem: MediaItem, adsId: Any, adPlaybackState: AdPlaybackState) {
    // Do something with the resulting ad playback state when stopped.
  }
}

Ява

private class AdsLoaderListener
    implements HlsInterstitialsAdsLoader.Listener {

  // implement HlsInterstitialsAdsLoader.Listener

  @Override
  public void onStart(MediaItem mediaItem, Object adsId, AdViewProvider adViewProvider) {
    // Do something when HLS media item with interstitials is started.
  }

  @Override
  public void onMetadata(
      MediaItem mediaItem,
      Object adsId,
      int adGroupIndex,
      int adIndexInAdGroup,
      Metadata metadata) {
    // Do something with metadata that is emitted by the ad media source of the given ad.
  }

  @Override
  public void onAdCompleted(
      MediaItem mediaItem, Object adsId, int adGroupIndex, int adIndexInAdGroup) {
    // Do something when ad completed playback.
  }

  // ... See JavaDoc for further callbacks

  @Override
  public void onStop(MediaItem mediaItem, Object adsId, AdPlaybackState adPlaybackState) {
    // Do something with the resulting ad playback state when stopped.
  }
}

Подробную документацию по всем доступным обратным вызовам см. в JavaDoc HlsInterstitialsAdsLoader.Listener .

Затем прослушиватель можно добавить в загрузчик объявлений:

Котлин

var listener  = AdsLoaderListener();
// Add the listener to the ads loader to receive ad loader events.
hlsInterstitialsAdsLoader.addListener(listener);

Ява

AdsLoaderListener listener = new AdsLoaderListener();
// Add the listener to the ads loader to receive ad loader events.
hlsInterstitialsAdsLoader.addListener(listener);

Жизненный цикл HlsInterstitialsAdsLoader

Экземпляр HlsInterstitialsAdsLoader или HlsInterstitialsAdsLoader.AdsMediaSourceFactory можно повторно использовать для нескольких экземпляров проигрывателя, создающих несколько источников мультимедиа, для которых необходимо загрузить рекламу.

Экземпляр может быть создан, например, в методе onCreate Activity , а затем повторно использован для нескольких экземпляров проигрывателя. Это работает, пока он используется одним экземпляром проигрывателя в одно и то же время. Это полезно для обычного случая использования, когда приложение переходит в фоновый режим, экземпляр проигрывателя уничтожается, а затем создается новый экземпляр, когда приложение снова переходит на передний план.

Котлин

// Create the ads loader instance (for example onCreate).
hlsInterstitialsAdsLoader = HlsInterstitialsAdsLoader(context);

// Build a player and set it on the ads loader (for example onStart).
player = ExoPlayer.Builder(context).build();
hlsInterstitialsAdsLoader.setPlayer(player);

// Release the player and unset it on the ads loader (for example onStop).
player.release();
hlsInterstitialsAdsLoader.setPlayer(null);

// Build another player and set it on the ads loader (for example onStart).
player = ExoPlayer.Builder(context).build();
hlsInterstitialsAdsLoader.setPlayer(player);

// Release the player and unset it on the ads loader (for example onStop).
player.release();
hlsInterstitialsAdsLoader.setPlayer(null);

// Release the ads loader when not used anymore  (for example onDestroy).
hlsInterstitialsAdsLoader.release();

Ява

// Create the ads loader instance (for example onCreate).
hlsInterstitialsAdsLoader = new HlsInterstitialsAdsLoader(context);

// Build a player and set it on the ads loader (for example onStart).
player = new ExoPlayer.Builder(context).build();
hlsInterstitialsAdsLoader.setPlayer(player);

// Release the player and unset it on the ads loader (for example onStop).
player.release();
hlsInterstitialsAdsLoader.setPlayer(null);

// Build another player and set it on the ads loader (for example onStart).
player = new ExoPlayer.Builder(context).build();
hlsInterstitialsAdsLoader.setPlayer(player);

// Release the player and unset it on the ads loader (for example onStop).
player.release();
hlsInterstitialsAdsLoader.setPlayer(null);

// Release the ads loader when not used anymore  (for example onDestroy).
hlsInterstitialsAdsLoader.release();

В общем случае убедитесь, что вы освободили старый экземпляр проигрывателя, прежде чем устанавливать следующий экземпляр проигрывателя на загрузчике рекламы. После того, как загрузчик рекламы будет освобожден, его больше нельзя будет использовать.

Настройка воспроизведения

ExoPlayer предоставляет несколько способов настройки воспроизведения под нужды вашего приложения. Примеры см. на странице «Настройка» .

Отключение подготовки без фрагментов

По умолчанию ExoPlayer будет использовать chunkless preparation. Это означает, что ExoPlayer будет использовать только информацию в многовариантном плейлисте для подготовки потока, что работает, если теги #EXT-X-STREAM-INF содержат атрибут CODECS .

Вам может потребоваться отключить эту функцию, если ваши медиа-сегменты содержат мультиплексированные дорожки с субтитрами, которые не объявлены в многовариантном плейлисте с тегом #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS . В противном случае эти дорожки с субтитрами не будут обнаружены и воспроизведены. Вы можете отключить подготовку без фрагментов в HlsMediaSource.Factory , как показано в следующем фрагменте. Обратите внимание, что это увеличит время запуска, так как ExoPlayer необходимо загрузить медиа-сегмент для обнаружения этих дополнительных дорожек, и предпочтительнее вместо этого объявить дорожки с субтитрами в многовариантном плейлисте.

Котлин

val hlsMediaSource =
  HlsMediaSource.Factory(dataSourceFactory)
    .setAllowChunklessPreparation(false)
    .createMediaSource(MediaItem.fromUri(hlsUri))

Ява

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 .
  • Обеспечьте долгосрочное окно. Одна минута или больше — это здорово.