HLS

ExoPlayer unterstützt HLS mit mehreren Containerformaten. Außerdem müssen die enthaltenen Audio- und Video-Sample-Formate unterstützt werden. Weitere Informationen finden Sie im Abschnitt Sample-Formate. 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
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-Updates JA
Neuladen der Playlist wird blockiert JA
Laden von Hinweisen zum Vorabladen blockieren JA Außer für Bytebereiche mit undefinierter 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

Wenn du einen HLS-Stream abspielen möchtest, benötigst du das HLS-Modul.

Kotlin

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

Groovy

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 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 sowohl der verfügbaren Bandbreite als auch der Gerätefunktionen.

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. Die Der onTimelineChanged-Callback von Player.Listener wird auch immer dann aufgerufen, wird das Manifest geladen. 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 Chunk deaktivieren

Standardmäßig verwendet ExoPlayer die Vorbereitung ohne Chunks. Das bedeutet, dass ExoPlayer nur die Informationen in der multivariaten Playlist verwendet, um den Stream vorzubereiten. Das funktioniert, wenn die #EXT-X-STREAM-INF-Tags das CODECS-Attribut 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 chunklose Vorbereitung in HlsMediaSource.Factory deaktivieren, wie im folgenden Snippet gezeigt. Hinweis: Dadurch verlängert sich die Startzeit, da ExoPlayer ein Mediensegment herunterladen muss, um diese zusätzlichen Titel zu finden. Es empfiehlt sich, die Untertiteltracks stattdessen in der mehrvariantenfähigen Playlist anzugeben.

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 Erklärung findest du in unserem Medium-Beitrag zur HLS-Wiedergabe in ExoPlayer. Die wichtigsten Punkte:

  • Verwenden Sie eine genaue Segmentdauer.
  • 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.
  • 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 #EXT-X-DISCONTINUITY-SEQUENCE-Tag.
  • Sorgen Sie für einen langen Live-Zeitraum. Mindestens eine Minute ist ausreichend.