ExoPlayer obsługuje funkcję SmoothStreaming w formacie kontenera FMP4. Strumienie multimediów muszą być demusowane, co oznacza, że wideo, dźwięk i tekst muszą być zdefiniowane w odrębnych elementach StreamIndex w pliku manifestu SmoothStreaming. Muszą być też obsługiwane dołączone do tego formaty dźwiękowe i wideo (szczegóły znajdziesz w sekcji Przykładowe formaty).
Cecha | Obsługiwane | Komentarze |
---|---|---|
Kontenery | ||
protokół FMP4 | TAK | Tylko strumienie zdemonstrowane |
Napisy | ||
TTML, | TAK | Umieszczone w FMP4 |
Ochrona treści | ||
PlayReady SL2000 | TAK | Tylko Android TV |
Odtwarzanie na żywo | ||
Standardowe odtwarzanie na żywo | TAK | |
Common Media Client Data (CMCD). | TAK | Przewodnik po integracji |
Korzystanie z elementu MediaItem
Aby odtworzyć strumień SmoothStreaming, musisz skorzystać z modułu SmoothStreaming.
Kotlin
implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.3.1")
Odlotowe
implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.3.1"
Następnie możesz utworzyć identyfikator MediaItem
dla identyfikatora URI pliku manifestu SmoothStreaming i przekazać go do odtwarzacza.
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();
Jeśli identyfikator URI nie kończy się na .ism/Manifest
, możesz przekazać MimeTypes.APPLICATION_SS
do setMimeType
z MediaItem.Builder
, by jednoznacznie wskazać typ treści.
ExoPlayer automatycznie dostosuje reprezentacje zdefiniowane w pliku manifestu, biorąc pod uwagę zarówno dostępną przepustowość, jak i możliwości urządzenia.
Korzystanie z SsMediaSource
Aby uzyskać więcej opcji dostosowywania, możesz utworzyć element SsMediaSource
i przekazać go bezpośrednio do odtwarzacza zamiast do 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();
Dostęp do pliku manifestu
Bieżący plik manifestu możesz pobrać, wywołując funkcję Player.getCurrentManifest
.
W przypadku SmoothStreaming musisz rzutować zwrócony obiekt na interfejs SsManifest
. Wywołanie zwrotne onTimelineChanged
dla Player.Listener
jest też wywoływane przy każdym wczytaniu pliku manifestu. Nastąpi to raz w przypadku treści na żądanie,
i często wiele razy w przypadku treści na żywo. Ten fragment kodu pokazuje, jak aplikacja może wykonać określone działanie po wczytaniu pliku manifestu.
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. } } });
Dostosowywanie odtwarzania
ExoPlayer daje wiele możliwości dostosowania odtwarzania do potrzeb aplikacji. Przykłady znajdziesz na stronie Dostosowywanie.