ExoPlayer unterstützt HLS mit mehreren Containerformaten. Die enthaltenen Audio- und Video-Beispielformate müssen ebenfalls unterstützt werden. Weitere Informationen finden Sie im Abschnitt Beispielformate. Wir empfehlen HLS-Inhaltserstellern nachdrücklich, HLS-Streams hoher Qualität zu generieren, wie hier beschrieben.
Funktion | Unterstützt | Kommentare |
---|---|---|
Container | ||
MPEG-TS | JA | |
FMP4/CMAF | JA | |
ADTS (AAC) | JA | |
MP3 | JA | |
Untertitel | ||
CEA-608 | JA | |
CEA-708 | JA | |
WebVTT | JA | |
Metadaten | ||
ID3 | JA | |
SCTE-35 | NEIN | |
Inhaltsschutz | ||
AES-128 | JA | |
AES-128-Beispiel | NEIN | |
Widevine | JA | API 19 oder höher (Schema „cenc“) und API 25 oder höher (Schema „cbcs“) |
PlayReady SL2000 | JA | Nur Android TV |
Serversteuerung | ||
Delta-Aktualisierungen | JA | |
Neuladen der Playlist wird blockiert | JA | |
Laden von Vorabladehinweisen blockieren | JA | Außer für Bytebereiche mit undefinierter Länge |
Live-Wiedergabe | ||
Regelmäßige Live-Wiedergabe | JA | |
HLS mit niedriger Latenz (Apple) | JA | |
HLS mit niedriger Latenz (Community) | NEIN | |
Common Media Client Data (CMCD) | JA | Integrationsleitfaden |
MediaItem verwenden
Zum Abspielen eines HLS-Streams ist eine Abhängigkeit vom HLS-Modul erforderlich.
Kotlin
implementation("androidx.media3:media3-exoplayer-hls:1.3.1")
Cool
implementation "androidx.media3:media3-exoplayer-hls:1.3.1"
Anschließend kannst du einen MediaItem
für einen HLS-Playlist-URI erstellen und an den Player übergeben.
Kotlin
// Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(hlsUri)) // 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(hlsUri)); // Prepare the player. player.prepare();
Wenn der URI nicht mit .m3u8
endet, können Sie MimeTypes.APPLICATION_M3U8
an setMimeType
von MediaItem.Builder
übergeben, um explizit den Inhaltstyp anzugeben.
Der URI des Medienelements kann entweder auf eine Medienplaylist oder eine Playlist mit mehreren Varianten verweisen. Wenn der URI auf eine Playlist mit mehreren Varianten verweist, in der mehrere #EXT-X-STREAM-INF
-Tags deklariert sind, nimmt ExoPlayer die Anpassung zwischen den Varianten automatisch vor und berücksichtigt dabei sowohl die verfügbare Bandbreite als auch die Gerätefunktionen.
HlsMediaSource verwenden
Weitere Anpassungsoptionen erhältst du, wenn du ein HlsMediaSource
erstellst und es direkt an den Player statt an einen MediaItem
weitergibst.
Kotlin
// Create a data source factory. val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory() // Create a HLS media source pointing to a playlist uri. val hlsMediaSource = HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri)) // Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the HLS media source as the playlist with a single media item. player.setMediaSource(hlsMediaSource) // Prepare the player. player.prepare()
Java
// Create a data source factory. DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory(); // Create a HLS media source pointing to a playlist uri. HlsMediaSource hlsMediaSource = new HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri)); // Create a player instance. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the HLS media source as the playlist with a single media item. player.setMediaSource(hlsMediaSource); // Prepare the player. player.prepare();
Auf das Manifest zugreifen
Du kannst das aktuelle Manifest abrufen, indem du Player.getCurrentManifest
aufrufst.
Für HLS sollten Sie das zurückgegebene Objekt in HlsManifest
umwandeln. Der onTimelineChanged
-Callback von Player.Listener
wird ebenfalls aufgerufen, wenn das Manifest geladen wird. Dies geschieht einmal bei On-Demand-Inhalten,
möglicherweise auch bei Live-Inhalten. Das folgende Code-Snippet zeigt, wie eine App beim Laden des Manifests Aktionen ausführen kann.
Kotlin
player.addListener( object : Player.Listener { override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) { val manifest = player.currentManifest if (manifest is HlsManifest) { // 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) { HlsManifest hlsManifest = (HlsManifest) manifest; // Do something with the manifest. } } });
Wiedergabe anpassen
ExoPlayer bietet mehrere Möglichkeiten, die Wiedergabe an die Anforderungen Ihrer App anzupassen. Beispiele finden Sie auf der Seite „Anpassen“.
Vorbereitung ohne Chunk deaktivieren
Standardmäßig verwendet ExoPlayer die Chunkless-Vorbereitung. Das bedeutet, dass ExoPlayer die Informationen in der Playlist mit mehreren Varianten nur zur Vorbereitung des Streams verwendet. Dies funktioniert, wenn die #EXT-X-STREAM-INF
-Tags das Attribut CODECS
enthalten.
Möglicherweise müssen Sie diese Funktion deaktivieren, wenn Ihre Mediensegmente gemuxte Untertitel enthalten, die nicht in der Playlist mit mehreren Varianten mit einem #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS
-Tag deklariert sind. Andernfalls werden diese Tracks mit Untertiteln nicht erkannt und abgespielt. Sie können die Vorbereitung ohne Blöcke in HlsMediaSource.Factory
deaktivieren, wie im folgenden Snippet gezeigt. Dadurch verlängert sich die Startzeit, da ExoPlayer ein Mediensegment herunterladen muss, um diese zusätzlichen Titel zu finden. Es empfiehlt sich, stattdessen die Titel mit Untertiteln in der Playlist mit mehreren Varianten zu deklarieren.
Kotlin
val hlsMediaSource = HlsMediaSource.Factory(dataSourceFactory) .setAllowChunklessPreparation(false) .createMediaSource(MediaItem.fromUri(hlsUri))
Java
HlsMediaSource hlsMediaSource = new HlsMediaSource.Factory(dataSourceFactory) .setAllowChunklessPreparation(false) .createMediaSource(MediaItem.fromUri(hlsUri));
Hochwertige HLS-Inhalte erstellen
Zur optimalen Nutzung von ExoPlayer gibt es bestimmte Richtlinien, die Sie befolgen können, um Ihren HLS-Inhalt zu verbessern. Eine ausführliche Erläuterung findest du in unserem Medium-Beitrag zur HLS-Wiedergabe in ExoPlayer. Die wichtigsten Punkte sind:
- Verwenden Sie eine genaue Segmentdauer.
- Verwenden Sie einen kontinuierlichen Medienstream. Vermeiden Sie segmentübergreifende Änderungen der Medienstruktur.
- Verwenden Sie das Tag
#EXT-X-INDEPENDENT-SEGMENTS
. - Aufgeteilte Streams sollten gegenüber Dateien, die sowohl Video- als auch Audiomaterial enthalten, bevorzugt verwendet werden.
- Füge der Playlist mit mehreren Varianten alle verfügbaren Informationen hinzu.
Die folgenden Richtlinien gelten speziell für Livestreams:
- Verwenden Sie das Tag
#EXT-X-PROGRAM-DATE-TIME
. - Verwenden Sie das Tag
#EXT-X-DISCONTINUITY-SEQUENCE
. - Sorgen Sie für ein langes Zeitfenster für die Live-Wiedergabe. Mindestens eine Minute ist ausreichend.