ExoPlayer obsługuje DASH z wieloma formatami kontenerów. Strumienie multimediów muszą być demuksowane, co oznacza, że wideo, dźwięk i tekst muszą być zdefiniowane w odrębnych elementach AdaptationSet
w pliku manifestu DASH (wyjątek CEA-608 jest opisany w tabeli poniżej). 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 |
WebM | TAK | Tylko zdecentralizowane strumienie |
Matroška | TAK | Tylko zdecentralizowane strumienie |
MPEG-TS | NIE | Nie zaplanowano pomocy |
Napisy | ||
TTML | TAK | Nieprzetworzony lub umieszczony w FMP4 zgodnie z normą ISO/IEC 14496-30 |
WebVTT | TAK | Nieprzetworzony lub umieszczony w FMP4 zgodnie z normą ISO/IEC 14496-30 |
CEA-608 | TAK | Umieszczony w FMP4 przy sygnalizowaniu za pomocą deskryptorów SCTE Accessibility |
CEA-708 | TAK | Umieszczony w FMP4 przy sygnalizowaniu za pomocą deskryptorów SCTE Accessibility |
Metadane | ||
Metadane EMSG | TAK | Umieszczone w FMP4 |
Ochrona treści | ||
Widevine | TAK | Schemat „cenc”: API 19+; schemat „cbcs”: API 25+ |
PlayReady SL2000 | TAK | Android TV, tylko schemat „cenc” |
ClearKey | TAK | API 21+, tylko schemat „cenc” |
Odtwarzanie na żywo | ||
Zwykłe odtwarzanie na żywo | TAK | |
Odtwarzanie na żywo w CMAF o bardzo małym opóźnieniu | TAK | |
Dane klienta Common Media Client Data (CMCD) | TAK | Przewodnik po integracji |
Korzystanie z elementu MediaItem
Aby odtwarzać strumień DASH, musisz korzystać z modułu DASH.
Kotlin
implementation("androidx.media3:media3-exoplayer-dash:1.3.1")
Odlotowy
implementation "androidx.media3:media3-exoplayer-dash:1.3.1"
Następnie możesz utworzyć obiekt 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 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 DashMediaSource
Aby uzyskać więcej opcji dostosowywania, utwórz DashMediaSource
i przekaż go bezpośrednio 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();
Uzyskiwanie dostępu do pliku manifestu
Bieżący plik manifestu możesz pobrać, wywołując Player.getCurrentManifest
.
W przypadku DASH zwracany obiekt należy rzutować na DashManifest
. Wywołanie zwrotne onTimelineChanged
dotyczące Player.Listener
jest też wywoływane przy każdym wczytaniu pliku manifestu. Może się to zdarzyć 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 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 oferuje wiele sposobów dostosowania odtwarzania do potrzeb aplikacji. Przykłady znajdziesz na stronie Dostosowywanie.