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çimleri bölümüne bakın). HLS içerik üreticilerini, burada açıklandığı gibi yüksek kaliteli HLS akışları oluşturmaya teşvik ediyoruz.

Ö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
ID3 EVET
SCTE-35 HAYIR
İçerik koruması
AES-128 EVET
Örnek AES-128 HAYIR
Widevine EVET API 19 ve üzeri ("cenc" şeması) ve 25 ve üzeri ("cbcs" şeması)
PlayReady SL2000 EVET Yalnızca Android TV
Sunucu kontrolü
Delta güncellemeleri EVET
Oynatma listesinin yeniden yüklenmesini engelleme EVET
Önceden yükleme ipuçlarının yüklenmesini engelleme EVET Uzunluğu tanımlanmamış bayt aralıkları hariç
Canlı oynatma
Normal canlı oynatma EVET
Düşük gecikmeli HLS (Apple) EVET
Düşük gecikmeli HLS (Topluluk) HAYIR
Ortak Medya İstemcisi Verileri (CMCD) EVET Entegrasyon Kılavuzu

MediaItem'i kullanma

HLS yayını oynatmak için HLS modülüne ihtiyacınız vardır.

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

Ardından, 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'niz .m3u8 ile bitmiyorsa içeriğin türünü açıkça belirtmek için MimeTypes.APPLICATION_M3U8'yi MediaItem.Builder'ın setMimeType bölümüne iletebilirsiniz.

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

HlsMediaSource'ı kullanma

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

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

Manifest'e erişim

Player.getCurrentManifest işlevini çağırarak geçerli manifest dosyasını alabilirsiniz. HLS için döndürülen nesneyi HlsManifest olarak yayınlamanız gerekir. Manifest her yüklendiğinde Player.Listener için onTimelineChanged geri çağırma işlevi de çağrılır. Bu işlem, istek üzerine içerikler için bir kez, canlı içerikler için ise muhtemelen birçok kez gerçekleşir. Aşağıdaki kod snippet'inde, bir uygulamanın manifest yüklendiğinde nasıl bir işlem yapabileceği gösterilmektedir.

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

Oynatma ayarlarını özelleştirme

ExoPlayer, oynatma deneyimini uygulamanızın ihtiyaçlarına göre özelleştirmenize olanak tanıyan birden fazla yöntem sunar. Örnekler için Özelleştirme sayfasına bakın.

Parçalara ayırmadan hazırlama işlemini devre dışı bırakma

ExoPlayer varsayılan olarak parçalara ayrılmamış hazırlama işlemini kullanır. Bu, ExoPlayer'ın yayını hazırlamak için yalnızca çok değişkenli oynatma listesinde bulunan bilgileri kullanacağı anlamına gelir. Bu, #EXT-X-STREAM-INF etiketleri CODECS özelliğini içeriyorsa işe yarar.

Medya segmentleriniz, çok değişkenli oynatma listesinde #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS etiketiyle tanımlanmayan, birleştirilmiş altyazı parçaları içeriyorsa bu özelliği devre dışı bırakmanız gerekebilir. Aksi takdirde bu altyazı kanalları algılanmaz ve oynatılmaz. Aşağıdaki snippet'te gösterildiği gibi HlsMediaSource.Factory içinde parçalara ayırmadan hazırlama özelliğini 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. Bunun yerine, altyazı parçalarını çok değişkenli oynatma listesinde belirtmeniz önerilir.

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çerikleri 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 oynatma hakkındaki Medium yayınımızı okuyun. Önemli noktalar şunlardır:

  • Kesin segment süreleri kullanın.
  • Kesintisiz bir medya akışı kullanın. Segmentler arasında 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ın yerine, ses ve videonun ayrıldığı akışları tercih edin.
  • Çok varyantlı oynatma listesine mümkün olduğunca fazla bilgi ekleyin.

Aşağıdaki yönergeler ö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 penceresi sağlayın. Bir dakika veya daha uzun süreli videolar idealdir.