HLS

O ExoPlayer oferece suporte a HLS com vários formatos de contêiner. O áudio contido e formatos de exemplo de vídeo também devem ser suportados (consulte a exemplos de formatos para mais detalhes). Recomendamos que os produtores de conteúdo HLS gerem streams HLS de alta qualidade, conforme descrito aqui.

Recurso Compatível Comentários
Contêineres
MPEG-TS SIM
FMP4/CMAF SIM
ADTS (AAC) SIM
MP3 SIM
Legendas legendas
CEA-608 SIM
CEA-708 SIM
WebVTT SIM
Metadados
ID3 SIM
SCTE-35 NÃO
Proteção de conteúdo
AES-128 SIM
Exemplo de AES-128 NÃO
Widevine SIM API 19+ (esquema cenc) e 25+ ("esquema cbcs")
PlayReady SL2000 SIM Somente no Android TV
Controle do servidor
Atualizações delta SIM
Bloqueando a atualização da playlist SIM
Bloquear o carregamento de dicas de pré-carregamento SIM Exceto para intervalos de bytes com comprimentos indefinidos
Reprodução ao vivo
Reprodução ao vivo normal SIM
HLS de baixa latência (Apple) SIM
HLS de baixa latência (Comunidade) NÃO
Dados comuns do cliente de mídia (CMCD, na sigla em inglês) SIM Guia de integração

Como usar o MediaItem

Para reproduzir uma transmissão HLS, é preciso depender do módulo HLS.

Kotlin

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

Groovy

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

Em seguida, crie um MediaItem para um URI de playlist HLS e transmita-o ao reprodutor.

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

Se o URI não terminar com .m3u8, você poderá transmitir MimeTypes.APPLICATION_M3U8 para setMimeType de MediaItem.Builder para indicar explicitamente o tipo de conteúdo.

O URI do item de mídia pode apontar para uma playlist de mídia ou uma multivariante lista de reprodução. Se o URI apontar para uma playlist com várias variantes que declara várias tags #EXT-X-STREAM-INF, o ExoPlayer vai se adaptar automaticamente entre as variantes, levando em conta a largura de banda disponível e os recursos do dispositivo.

Como usar HlsMediaSource

Para mais opções de personalização, você pode criar um HlsMediaSource e transmiti-lo diretamente ao player em vez de um 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();

Como acessar o manifesto

É possível extrair o manifesto atual chamando Player.getCurrentManifest. Para HLS, transmita o objeto retornado para HlsManifest. O callback onTimelineChanged de Player.Listener também é chamado sempre que o manifesto é carregado. Isso vai acontecer uma vez para conteúdo on demand e talvez muitas vezes para conteúdo ao vivo. O snippet de código a seguir mostra como um app pode fazer algo sempre que o manifesto for carregado.

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

Como personalizar a reprodução

O ExoPlayer oferece várias maneiras de personalizar a experiência de reprodução de acordo com seu às necessidades do seu app. Consulte a página de personalização para conferir exemplos.

Como desativar a preparação sem fragmentos

Por padrão, o ExoPlayer usará a preparação sem partes. Isso significa que o ExoPlayer só usará as informações na playlist multivariante para preparar o stream, que funciona se as tags #EXT-X-STREAM-INF contiverem o CODECS. .

Talvez seja necessário desativar esse recurso se os segmentos de mídia tiverem multiplexados faixas de legenda descritiva que não são declaradas na playlist multivariante com um #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS. Caso contrário, essas faixas de legenda não serão detectadas e reproduzidas. É possível desativar a preparação sem separações em HlsMediaSource.Factory, conforme mostrado no snippet a seguir. Isso vai aumentar o tempo de inicialização, já que o ExoPlayer precisa fazer o download de um segmento de mídia para descobrir essas faixas adicionais. É preferível declarar as faixas de legenda na playlist de variantes múltiplas.

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

Como criar conteúdo HLS de alta qualidade

Para aproveitar ao máximo o ExoPlayer, existem algumas diretrizes que você pode seguir seguir para melhorar seu conteúdo de HLS. Leia nossa postagem no Medium sobre a reprodução de HLS no ExoPlayer para uma explicação completa. Os pontos principais são:

  • Use durações de segmento precisas.
  • Use uma transmissão de mídia contínua. Evite mudanças na estrutura de mídia em segmentos.
  • Use a tag #EXT-X-INDEPENDENT-SEGMENTS.
  • Prefira transmissões com multiplexação revertida em vez de arquivos que incluem vídeo e áudio.
  • Inclua todas as informações possíveis na playlist multivariante.

As seguintes diretrizes se aplicam especificamente às transmissões ao vivo:

  • Use a tag #EXT-X-PROGRAM-DATE-TIME.
  • Use a tag #EXT-X-DISCONTINUITY-SEQUENCE.
  • Forneça uma janela ativa longa. Um minuto ou mais é ótimo.