ExoPlayer obsługuje DASH z wieloma formatami kontenerów. Strumienie multimediów muszą być:
demuksowany, co oznacza, że wideo, dźwięk i tekst muszą być zdefiniowane osobno.
elementów AdaptationSet
w manifeście DASH (CEA-608 jest wyjątkiem
opisane w tabeli poniżej). Zawarte w nim przykładowe formaty dźwięku i wideo muszą
również być obsługiwane (zobacz
przykładowe formaty).
Funkcja | Obsługiwane | Komentarze |
---|---|---|
Kontenery | ||
FMP4 | TAK | Tylko strumienie zdemonstrowane |
WebM | TAK | Tylko strumienie zdemonstrowane |
Matroska | TAK | Tylko strumienie zdemonstrowane |
MPEG-TS | NIE | Pomoc nie jest planowana |
Napisy | ||
TTML | TAK | Nieprzetworzone lub umieszczone w FMP4 zgodnie z normą ISO/IEC 14496-30 |
WebVTT | TAK | Nieprzetworzone lub umieszczone w FMP4 zgodnie z normą ISO/IEC 14496-30 |
CEA-608 | TAK | Umieszczony w FMP4 po sygnalizowaniu za pomocą deskryptorów ułatwień dostępu SCTE |
CEA-708 | TAK | Umieszczony w FMP4 po sygnalizowaniu za pomocą deskryptorów ułatwień dostępu SCTE |
Metadane | ||
Metadane EMSG | TAK | Umieszczone w FMP4 |
Ochrona treści | ||
Widevine | TAK | „cenc” schemat: API 19+; „cbcs” schemat: API 25+ |
PlayReady SL2000 | TAK | Android TV, „cenc” tylko schemat |
Wyczyść klucz | TAK | API 21+, „cenc” tylko schemat |
Odtwarzanie na żywo | ||
Standardowe odtwarzanie na żywo | TAK | |
Odtwarzanie na żywo w CMAF z bardzo małym opóźnieniem | TAK | |
Common Media Client Data (CMCD). | TAK | Przewodnik po integracji |
Korzystanie z elementu MediaItem
Aby odtworzyć strumień DASH, musisz skorzystać z modułu DASH.
Kotlin
implementation("androidx.media3:media3-exoplayer-dash:1.4.1")
Odlotowe
implementation "androidx.media3:media3-exoplayer-dash:1.4.1"
Następnie możesz utworzyć identyfikator MediaItem
dla identyfikatora URI MPD DASH 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(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();
Jeśli identyfikator URI nie kończy się na .mpd
, możesz przekazać MimeTypes.APPLICATION_MPD
do setMimeType
z MediaItem.Builder
, aby jednoznacznie wskazać typ
treści.
ExoPlayer automatycznie dostosuje się między reprezentacjami określonymi w z uwzględnieniem dostępnej przepustowości i możliwości urządzenia.
Korzystanie z DashMediaSource
Aby uzyskać więcej opcji dostosowywania, możesz utworzyć DashMediaSource
i przekazać go
prosto do odtwarzacza, a nie 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();
Dostęp do pliku manifestu
Bieżący plik manifestu możesz pobrać, wywołując funkcję Player.getCurrentManifest
.
W przypadku DASH należy rzutować zwrócony obiekt na platformę DashManifest
.
Wywołanie zwrotne funkcji onTimelineChanged
z Player.Listener
jest również wywoływane, gdy
plik manifestu został wczytany. Odbywa się to jednorazowo w przypadku treści na żądanie.
być może przy treściach na żywo. Ten fragment kodu pokazuje, jak aplikacja
może wykonać jakąś czynność po załadowaniu pliku manifestu.
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. } } });
Dostosowywanie odtwarzania
ExoPlayer daje wiele możliwości dostosowania odtwarzania do do potrzeb Twojej aplikacji. Przykłady znajdziesz na stronie Dostosowywanie.