HLS

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.

MediaItem verwenden

Zum Abspielen eines HLS-Streams ist eine Abhängigkeit vom HLS-Modul erforderlich.

implementation("androidx.media3:media3-exoplayer-hls:1.3.1")

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.

// 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()

// 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.

// 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()

// 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.

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.
      }
    }
  }
)

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.

val hlsMediaSource =
  HlsMediaSource.Factory(dataSourceFactory)
    .setAllowChunklessPreparation(false)
    .createMediaSource(MediaItem.fromUri(hlsUri))

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.