ExoPlayer obsługuje SmoothStreaming w formacie kontenera FMP4. Strumienie multimediów muszą być zdemiksowane, 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 przykładowe formaty audio i wideo (szczegóły znajdziesz w sekcji przykładowe formaty).
Cecha | Obsługiwane | Komentarze |
---|---|---|
Kontenery | ||
FMP4 | TAK | Tylko zdecentralizowane strumienie |
Napisy | ||
TTML | TAK | Umieszczone w FMP4 |
Ochrona treści | ||
PlayReady SL2000 | TAK | Tylko Android TV |
Odtwarzanie na żywo | ||
Zwykłe odtwarzanie na żywo | TAK | |
Dane klienta Common Media Client Data (CMCD) | TAK | Przewodnik po integracji |
Korzystanie z elementu MediaItem
Do odtwarzania strumienia SmoothStreaming potrzebny jest moduł SmoothStreaming.
Kotlin
implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.3.1")
Odlotowy
implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.3.1"
Następnie możesz utworzyć obiekt 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ć parametr MimeTypes.APPLICATION_SS
do setMimeType
z MediaItem.Builder
, aby wyraźnie wskazać typ treści.
ExoPlayer automatycznie dostosuje się do reprezentacji zdefiniowanych 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, utwórz SsMediaSource
i przekaż go bezpośrednio do odtwarzacza, a nie 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();
Uzyskiwanie dostępu do pliku manifestu
Bieżący plik manifestu możesz pobrać, wywołując Player.getCurrentManifest
.
W przypadku SmoothStreaming zwrócony obiekt należy rzutować na SsManifest
. Wywołanie zwrotne onTimelineChanged
dotyczące Player.Listener
jest też wywoływane przy każdym wczytaniu pliku manifestu. Zdarza się to raz w przypadku treści na żądanie,
a często nawet wielokrotnie w przypadku treści na żywo. Ten fragment kodu pokazuje, jak aplikacja może wykonać jakąś czynność przy wczytywaniu 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 oferuje wiele sposobów dostosowania odtwarzania do potrzeb aplikacji. Przykłady znajdziesz na stronie Dostosowywanie.