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-Inhaltsproduzenten dringend, HLS-Streams in 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 | |
Beispiel AES-128 | NEIN | |
Widevine | JA | API 19+ („cenc“-Schema) und 25+ („cbcs“-Schema) |
PlayReady SL2000 | JA | Nur Android TV |
Serversteuerung | ||
Delta-Updates | JA | |
Neuladen der Playlist wird blockiert | JA | |
Laden von Hinweisen zum Vorabladen blockieren | JA | Außer für Bytebereiche mit nicht definierter Länge |
Livewiedergabe | ||
Regelmäßige Livewiedergabe | 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.4.1")
Cool
implementation "androidx.media3:media3-exoplayer-hls:1.4.1"
Du kannst dann eine 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 mehrvariantige Playlist verweisen. Wenn der URI auf eine mehrvariantige Playlist verweist, die mehrere #EXT-X-STREAM-INF
-Tags deklariert, passt sich ExoPlayer automatisch zwischen den Varianten an. Dabei werden sowohl die verfügbare Bandbreite als auch die Gerätefunktionen berücksichtigt.
HlsMediaSource verwenden
Wenn du mehr Anpassungsoptionen benötigst, kannst du statt einer MediaItem
eine HlsMediaSource
erstellen und direkt an den Player übergeben.
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
Sie können das aktuelle Manifest durch Aufrufen von Player.getCurrentManifest
abrufen.
Bei HLS solltest du das zurückgegebene Objekt in HlsManifest
umwandeln. Der onTimelineChanged
-Callback von Player.Listener
wird auch jedes Mal aufgerufen, wenn das Manifest geladen wird. Bei On-Demand-Inhalten geschieht dies einmal, bei Livestreams möglicherweise mehrmals. Das folgende Code-Snippet zeigt, wie eine App etwas tun kann, wenn das Manifest geladen wird.
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
Mit ExoPlayer hast du mehrere Möglichkeiten, die Wiedergabe an die Anforderungen deiner App anzupassen. Beispiele finden Sie auf der Seite „Anpassen“.
Vorbereitung ohne Chunks deaktivieren
Standardmäßig verwendet ExoPlayer die chunklose 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 Untertitelungstracks nicht erkannt und wiedergegeben. Sie können die chunklose Vorbereitung 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));
HLS-Inhalte in hoher Qualität erstellen
Damit du ExoPlayer optimal nutzen kannst, gibt es bestimmte Richtlinien, mit denen du deine HLS-Inhalte verbessern kannst. Eine ausführliche Erläuterung findest du in unserem Medium-Beitrag zur HLS-Wiedergabe in ExoPlayer. Die wichtigsten Punkte:
- Verwenden Sie genaue Segmentdauern.
- Verwende einen kontinuierlichen Medienstream und vermeide Änderungen an der Medienstruktur in den einzelnen Segmenten.
- Verwenden Sie das
#EXT-X-INDEPENDENT-SEGMENTS
-Tag. - Verwende demultiplexierte Streams anstelle von Dateien, die sowohl Video als auch Audio enthalten.
- Geben Sie in der Playlist mit mehreren Varianten alle Informationen an, die Sie haben.
Die folgenden Richtlinien gelten speziell für Livestreams:
- Verwenden Sie das
#EXT-X-PROGRAM-DATE-TIME
-Tag. - Verwenden Sie das
#EXT-X-DISCONTINUITY-SEQUENCE
-Tag. - Bieten Sie ein langes Live-Fenster. Mindestens eine Minute ist ausreichend.