HLS

ExoPlayer, birden fazla container biçimiyle HLS'yi destekler. İçerikteki 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.

Özellik	Destekleniyor	Yorumlar
Kapsayıcılar
MPEG-TS	EVET
FMP4/CMAF	EVET
ADTS (AAC)	EVET
MP3	EVET
Altyazılar
CEA-608	EVET
CEA-708	EVET
WebVTT	EVET
Meta veri
Kimlik 3	EVET
SCTE-35	HAYIR
İçerik koruması
AES-128	EVET
Örnek AES-128	HAYIR
Widevine	EVET	API 19+ ("cenc" şeması) ve 25+ ("cbcs" şeması)
PlayReady SL2000	EVET	Yalnızca Android TV
Sunucu denetimi
Delta güncellemeleri	EVET
Oynatma listesinin yeniden yüklenmesini engelleme	EVET
Önceden yükleme ipuçlarının yüklenmesini engelleme	EVET	Uzunlukları tanımlanmamış bayt aralıkları hariç
Canlı oynatma
Düzenli canlı oynatma	EVET
Düşük gecikmeli HLS (Apple)	EVET
Düşük gecikmeli HLS (Topluluk)	HAYIR
Ortak Medya İstemci Verileri (CMCD)	EVET	Entegrasyon Kılavuzu

MediaItem'i Kullanma

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

Kotlin

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

Eski

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

Daha sonra, HLS oynatma listesi URI'si için bir MediaItem oluşturabilir ve bunu oynatıcıya aktarabilirsiniz.

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

URI'niz .m3u8 ile bitmiyorsa içeriğin türünü açıkça belirtmek için MimeTypes.APPLICATION_M3U8 öğesini setMimeType/MediaItem.Builder öğesine iletebilirsiniz.

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

HlsMediaSource'u Kullanma

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

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

Manifest dosyasına erişme

Player.getCurrentManifest öğesini ç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 yapılır. Bu durum yalnızca seç-izle içeriklerde bir kez, canlı içeriklerde muhtemelen birçok kez gerçekleşir. Aşağıdaki kod snippet'i, manifest yüklendiğinde bir uygulamanın nasıl bir işlem yapabileceğini gösterir.

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

Oynatmayı özelleştirme

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

Yığınsız hazırlığı devre dışı bırakma

ExoPlayer, varsayılan olarak parçasız hazırlık kullanır. Bu, ExoPlayer'ın akışı hazırlamak için yalnızca çok değişkenli oynatma listesindeki bilgileri kullanacağı anlamına gelir. #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, karışık altyazı parçaları içeriyorsa bu özelliği devre dışı bırakmanız gerekebilir. Aksi takdirde, bu altyazı parçaları algılanmaz ve çalınmaz. Yığınsız hazırlamayı, 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 bu işlemin başlatma süresini artıracağını unutmayın. Ayrıca, altyazı parçalarının çok değişkenli oynatma listesinde bildirilmesi tercih edilir.

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

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

ExoPlayer'dan en iyi şekilde yararlanmak için HLS içeriğinizi iyileştirmek üzere uygulayabileceğiniz belirli yönergeler vardır. Tam açıklama için ExoPlayer'da HLS oynatmayla ilgili Medium yayınımızı okuyun. Temel noktalar şunlardır:

• Kesin segment sürelerini kullanın.
• Sürekli bir medya akışı kullanın ve segmentler arasındaki medya yapısında değişiklikler yapmaktan kaçının.
• #EXT-X-INDEPENDENT-SEGMENTS etiketini kullanın.
• Hem video hem de ses içeren dosyalar yerine, devre dışı bırakılmış akışları tercih edin.
• Çok Değişkenli Oynatma Listesi'nde bulabildiğ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 yayın aralığı belirleyin. Bir dakika veya daha uzun süre iyidir.