HLS

ExoPlayer, birden fazla kapsayıcı biçimiyle HLS'yi destekler. İçerdiği ses ve video örnek biçimleri de desteklenmelidir (ayrıntılar için örnek biçimler bölümüne bakın). HLS içerik üreticilerinin, burada açıklandığı gibi yüksek kaliteli HLS akışları oluşturmalarını önemle tavsiye ederiz.

MediaItem kullanma

Bir HLS akışını oynatmak için HLS modülüne bağımlı olmanız gerekir.

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

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

Daha sonra, HLS oynatma listesi URI'si için bir MediaItem oluşturup oynatıcıya iletebilirsiniz.

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

URI'nız .m3u8 ile bitmiyorsa içeriğin türünü açık bir şekilde belirtmek için MimeTypes.APPLICATION_M3U8 öğesini setMimeType/MediaItem.Builder geçirebilirsiniz.

Medya öğesinin URI'sı, bir medya oynatma listesini veya çok değişkenli oynatma listesini işaret edebilir. URI, birden fazla #EXT-X-STREAM-INF etiketi bildiren çok değişkenli bir oynatma listesini işaret ederse ExoPlayer, hem kullanılabilir bant genişliğini hem de cihaz özelliklerini hesaba katarak varyantlar arasında otomatik olarak uyum sağlar.

HlsMediaSource'u kullanma

Daha fazla özelleştirme seçeneği için HlsMediaSource oluşturup MediaItem yerine doğrudan oynatıcıya aktarabilirsiniz.

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

Manifeste erişme

Player.getCurrentManifest yöntemini çağırarak geçerli manifesti alabilirsiniz. HLS için döndürülen nesneyi HlsManifest öğesine yayınlamanız gerekir. Manifest her yüklendiğinde Player.Listener için onTimelineChanged geri çağırması da çağrılır. Bu durum, seç-izle içeriklerde bir kez, canlı içeriklerde de pek çok kez gerçekleşir. Aşağıdaki kod snippet'i, manifest dosyası her yüklendiğinde bir uygulamanın nasıl işlem yapabileceğini göstermektedir.

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

Oynatmayı özelleştirme

ExoPlayer, oynatma deneyimini uygulamanızın ihtiyaçlarına göre uyarlamanız için çeşitli yollar sunar. Örnekler için Özelleştirme sayfasına bakın.

Parçasız hazırlığı devre dışı bırakma

ExoPlayer varsayılan olarak parçasız hazırlamayı kullanır. Bu, ExoPlayer'ın akışı hazırlamak için yalnızca çok değişkenli oynatma listesindeki bilgileri kullanacağı anlamına gelir. Bu, #EXT-X-STREAM-INF etiketleri CODECS özelliğini içeriyorsa çalışır.

Medya segmentleriniz, çok değişkenli oynatma listesinde #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS etiketiyle bildirilmeyen karma altyazılı parçalar içeriyorsa bu özelliği devre dışı bırakmanız gerekebilir. Aksi takdirde, bu altyazılı parçalar algılanmaz ve çalınmaz. Parçasız hazırlığı aşağıdaki snippet'te gösterildiği gibi HlsMediaSource.Factory içinde devre dışı bırakabilirsiniz. ExoPlayer'ın bu ek parçaları keşfetmek için bir medya segmenti indirmesi gerektiğinden ve bunun yerine kapalı altyazılı parçaların çok değişkenli oynatma listesinde belirtilmesi tercih edildiğinden, bu işlemin başlatma süresini uzatacağını unutmayın.

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

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

Yüksek kaliteli HLS içeriği oluşturma

ExoPlayer'dan en iyi şekilde yararlanmak için HLS içeriğinizi iyileştirmek amacıyla uygulayabileceğiniz belirli kurallar vardır. Ayrıntılı açıklama için ExoPlayer'da HLS oynatmayla ilgili Medium yayınımızı okuyun. Temel noktalar şunlardır:

• Kesin segment süreleri kullanın.
• Kesintisiz bir medya akışı kullanın; tüm segmentlerdeki medya yapısında değişiklik yapmaktan kaçının.
• #EXT-X-INDEPENDENT-SEGMENTS etiketini kullanın.
• Hem video hem de ses içeren dosyalar yerine tekilleştirilmiş akışları tercih edin.
• Çok Değişkenli Oynatma Listesine yapabildiğiniz tüm bilgileri ekleyin.

Aşağıdaki kurallar özellikle canlı yayınlar için geçerlidir:

• #EXT-X-PROGRAM-DATE-TIME etiketini kullanın.
• #EXT-X-DISCONTINUITY-SEQUENCE etiketini kullanın.
• Uzun bir canlı yayın aralığı sunun. Bir dakika veya daha uzun bir süre idealdir.