SmoothStreaming

O ExoPlayer oferece suporte ao SmoothStreaming com o formato de contêiner FMP4. Os fluxos de mídia precisam ser desmultiplexados, o que significa que o vídeo, o áudio e o texto precisam ser definidos em elementos StreamIndex distintos no manifesto do SmoothStreaming. Os formatos de amostra de áudio e vídeo contidos também precisam ser compatíveis. Consulte a seção de formatos de amostra para mais detalhes.

Recurso Compatível Comentários
Contêineres
FMP4 SIM Somente fluxos desmultiplexados
Legendas ocultas/legendas
TTML SIM Incorporado no FMP4
Proteção de conteúdo
PlayReady SL2000 SIM Somente no Android TV
Reprodução ao vivo
Reprodução ao vivo normal SIM
Dados comuns do cliente de mídia (CMCD, na sigla em inglês) SIM Guia de integração

Como usar MediaItem

Para reproduzir um fluxo do SmoothStreaming, é necessário depender do módulo SmoothStreaming.

Kotlin

implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.10.0")

Groovy

implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.10.0"

Em seguida, você pode criar um MediaItem para um URI de manifesto do SmoothStreaming 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(ssUri))
// 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(ssUri));
// Prepare the player.
player.prepare();

Se o URI não terminar com .ism/Manifest, você poderá transmitir MimeTypes.APPLICATION_SS 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, considerando a largura de banda disponível e os recursos do dispositivo.

Como usar SsMediaSource

Para mais opções de personalização, você pode criar um SsMediaSource 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 SmoothStreaming media source pointing to a manifest uri.
val mediaSource: MediaSource =
  SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri))
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media source to be played.
player.setMediaSource(mediaSource)
// Prepare the player.
player.prepare()

Java

// Create a data source factory.
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a SmoothStreaming media source pointing to a manifest uri.
MediaSource mediaSource =
    new SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri));
// Create a player instance.
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

Você pode recuperar o manifesto atual chamando Player.getCurrentManifest. Para o SmoothStreaming, é necessário converter o objeto retornado em SsManifest. O callback onTimelineChanged de Player.Listener também é chamado sempre que o manifesto é carregado. Isso acontece uma vez para conteúdo on demand e possivelmente 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 SsManifest) {
        // 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) {
          SsManifest ssManifest = (SsManifest) 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 seu app. Consulte a página de personalização para ver exemplos.