HLS

ExoPlayer unterstützt HLS mit mehreren Containerformaten. Die enthaltenen Audio- und Video-Beispielformate müssen ebenfalls unterstützt werden (siehe Beispielformate. Mi. Ersteller von HLS-Content ausdrücklich ermutigen, HLS-Streams hoher Qualität zu generieren wie beschrieben hier.

MediaItem verwenden

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

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

implementation "androidx.media3:media3-exoplayer-hls:1.4.1"

Du kannst dann einen MediaItem für einen HLS-Playlist-URI erstellen und an den Player.

// 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 Ihr URI nicht auf .m3u8 endet, können Sie MimeTypes.APPLICATION_M3U8 übergeben. bis setMimeType von MediaItem.Builder, um explizit den Typ des Inhalte.

Der URI des Medienelements kann entweder auf eine Mediaplaylist oder eine Multivariante verweisen. . Wenn der URI auf eine Playlist mit mehreren Varianten verweist, in der mehrere Varianten deklariert sind #EXT-X-STREAM-INF-Tags enthält, passt sich der ExoPlayer automatisch an Varianten unter Berücksichtigung der verfügbaren Bandbreite und der Gerätefunktionen.

HlsMediaSource verwenden

Weitere Anpassungsoptionen erhalten Sie, wenn Sie eine HlsMediaSource erstellen und übergeben. direkt an den Spieler statt an MediaItem.

// 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. Die Der onTimelineChanged-Callback von Player.Listener wird auch immer dann aufgerufen, wird das Manifest geladen. Dies geschieht einmal bei On-Demand-Inhalten und bei Live-Inhalten häufig vor. Das folgende Code-Snippet zeigt, wie eine App Aktionen ausführen können, wenn das Manifest geladen wird.

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

Mit ExoPlayer können Sie die Wiedergabe auf verschiedene die Anforderungen der App zu erfüllen. Beispiele finden Sie auf der Seite „Anpassen“.

Vorbereitung ohne Chunk deaktivieren

Standardmäßig verwendet ExoPlayer die chunklose Vorbereitung. Das bedeutet, dass ExoPlayer werden die Informationen in der Playlist mit mehreren Varianten nur zur Vorbereitung der Stream, der funktioniert, wenn die #EXT-X-STREAM-INF-Tags das CODECS-Element enthalten .

Möglicherweise müssen Sie diese Funktion deaktivieren, wenn Ihre Mediensegmente gemuxtes Titel mit Untertiteln, die nicht in der Playlist mit mehreren Varianten deklariert sind, mit einem Attribut #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS-Tag. Andernfalls werden diese Untertitel erkannt und abgespielt. Sie können die Vorbereitung ohne Blöcke in der HlsMediaSource.Factory, wie im folgenden Snippet gezeigt. Beachten Sie, dass dies verlängert die Startzeit, da ExoPlayer ein Mediensegment herunterladen muss, um diese zusätzlichen Tracks nicht finden können, und es ist besser, Titel mit Untertiteln stattdessen in der Playlist mit mehreren Varianten.

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

Mit den folgenden Richtlinien können Sie ExoPlayer optimal nutzen wie Sie Ihren HLS-Content verbessern können. Lies unseren Medium-Beitrag zur HLS-Wiedergabe in ExoPlayer für eine ausführliche Erläuterung. Die wichtigsten Punkte sind:

• Verwenden Sie eine genaue Segmentdauer.
• Einen kontinuierlichen Medienstream verwenden um Änderungen in der Medienstruktur Segmente.
• 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.