O ExoPlayer oferece suporte ao DASH com vários formatos de contêiner. As transmissões de mídia precisam ser
desmuxadas, ou seja, vídeo, áudio e texto precisam ser definidos em elementos
AdaptationSet
distintos no manifesto DASH. A CEA-608 é uma exceção, conforme
descrito na tabela abaixo. Os formatos de amostra de áudio e vídeo contidos também precisam
ser compatíveis (consulte a seção
Formatos de amostra para mais detalhes).
Recurso | Compatível | Comentários |
---|---|---|
Contêineres | ||
FMP4 | SIM | Somente transmissões demuxadas |
WebM | SIM | Somente transmissões desmultiplexadas |
Matroska | SIM | Somente transmissões desmultiplexadas |
MPEG-TS | NÃO | Nenhum suporte planejado |
Legendas/closed captions | ||
TTML | SIM | Raw ou incorporado em FMP4 de acordo com a ISO/IEC 14496-30 |
WebVTT | SIM | Raw ou incorporado em FMP4 de acordo com a ISO/IEC 14496-30 |
CEA-608 | SIM | Incorporado ao FMP4 quando indicado usando descritores de acessibilidade SCTE |
CEA-708 | SIM | Incorporado ao FMP4 quando indicado usando descritores de acessibilidade SCTE |
Metadados | ||
Metadados do EMSG | SIM | Incorporado no FMP4 |
Proteção de conteúdo | ||
Widevine | SIM | Esquema "cenc": API 19+; esquema "cbcs": API 25+ |
PlayReady SL2000 | SIM | Android TV, esquema "cenc" |
ClearKey | SIM | API 21+, esquema "cenc" |
Reprodução ao vivo | ||
Reprodução ao vivo normal | SIM | |
Reprodução ao vivo 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 uma transmissão DASH, você precisa depender do módulo DASH.
Kotlin
implementation("androidx.media3:media3-exoplayer-dash:1.5.0")
Groovy
implementation "androidx.media3:media3-exoplayer-dash:1.5.0"
Em seguida, crie um MediaItem
para um URI MPD DASH e transmita-o para o 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();
Se o URI não terminar com .mpd
, você poderá transmitir MimeTypes.APPLICATION_MPD
para setMimeType
de MediaItem.Builder
para indicar explicitamente o tipo de
conteúdo.
O ExoPlayer se adapta automaticamente entre as representações definidas no manifesto, levando em conta a largura de banda disponível e os recursos do dispositivo.
Como usar o DashMediaSource
Para mais opções de personalização, crie uma DashMediaSource
e transmita-a
diretamente ao player em vez de uma 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 extrair o manifesto atual chamando Player.getCurrentManifest
.
Para o DASH, você precisa transmitir o objeto retornado para DashManifest
. O
callback onTimelineChanged
de Player.Listener
também é chamado sempre que
o manifesto é carregado. Isso vai acontecer uma vez para um 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 é 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 as necessidades do app. Consulte a página de personalização para conferir exemplos.