DASH

O ExoPlayer oferece suporte ao DASH com vários formatos de contêiner. Os streams de mídia precisam ser com multiplexação, ou seja, vídeo, áudio e texto precisam ser definidos de maneira AdaptationSet no manifesto DASH (o CEA-608 é uma exceção, descritos na tabela abaixo). Os formatos de amostra de áudio e vídeo contidos devem tenham suporte (consulte a exemplos de formatos para mais detalhes).

Recurso	Compatível	Comentários
Contêineres
FMP4	SIM	Somente streams duplicados
WebM	SIM	Somente streams duplicados
Matroska	SIM	Somente streams duplicados
MPEG-TS	NÃO	Nenhum suporte planejado
Legendas legendas
TTML	SIM	Bruto ou incorporado em FMP4 de acordo com a norma ISO/IEC 14496-30
WebVTT	SIM	Bruto ou incorporado em FMP4 de acordo com a norma ISO/IEC 14496-30
Certificado CEA-608	SIM	Incorporado no FMP4 quando sinalizado usando descritores de acessibilidade SCTE
Certificado CEA 708	SIM	Incorporado no FMP4 quando sinalizado usando descritores de acessibilidade SCTE
Metadados
Metadados EMSG	SIM	Incorporado ao FMP4
Proteção de conteúdo
Widevine	SIM	"cenc" schema: API 19+; "cbcs" esquema: API 25 ou mais recente
PlayReady SL2000	SIM	Android TV, "cenc" Somente esquema
ClearKey	SIM	API 21+, "cenc" Somente esquema
Reprodução ao vivo
Reprodução ao vivo regular	SIM
Reprodução ao vivo do CMAF de latência ultrabaixa	SIM
Dados comuns do cliente de mídia (CMCD, na sigla em inglês)	SIM	Guia de integração

Como usar o MediaItem

Para reproduzir um stream DASH, você precisa depender do módulo DASH.

Kotlin

implementation("androidx.media3:media3-exoplayer-dash:1.4.0")

Groovy

implementation "androidx.media3:media3-exoplayer-dash:1.4.0"

Em seguida, você pode criar um MediaItem para um URI de MPD DASH e transmiti-lo ao player.

Kotlin

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

Java

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

Caso o URI não termine com .mpd, transmita MimeTypes.APPLICATION_MPD. setMimeType de MediaItem.Builder para indicar explicitamente o tipo de conteúdo.

O ExoPlayer se adaptará automaticamente entre as representações definidas no da Web, considerando a largura de banda disponível e as capacidades do dispositivo.

Como usar a DashMediaSource

Para mais opções de personalização, você pode criar um DashMediaSource e transmiti-lo diretamente ao player em vez de um MediaItem.

Kotlin

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

Java

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

Como acessar o manifesto

É possível recuperar o manifesto atual chamando Player.getCurrentManifest. Para DASH, você precisa transmitir o objeto retornado para DashManifest. A O callback onTimelineChanged de Player.Listener também é chamado sempre que o manifesto é carregado. Isso acontecerá uma vez para um conteúdo sob demanda, e possivelmente várias vezes em 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 DashManifest) {
        // 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) {
          DashManifest dashManifest = (DashManifest) 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 "Personalização" para ver exemplos.