ExoPlayer, birden fazla kapsayıcı biçimiyle HLS'yi destekler. İçerikteki ses ve video örnek biçimleri de desteklenmelidir (bkz. örnek biçimler 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 | ||
Kimlik 3 | 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.
Kotlin
implementation("androidx.media3:media3-exoplayer-hls:1.4.1")
Groovy
implementation "androidx.media3:media3-exoplayer-hls:1.4.1"
Ardından bir HLS oynatma listesi URI'si için MediaItem
oluşturabilir ve bunu
oynatıcıya gitmiş olur.
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
'yi MediaItem.Builder
'ın setMimeType
parametresine iletebilirsiniz.
Medya öğesinin URI'sı bir medya oynatma listesine veya çok değişkenli bir öğeye işaret edebilir
oynatma listesi. 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'u Kullanma
Daha fazla özelleştirme seçeneği için MediaItem
yerine HlsMediaSource
oluşturup doğrudan oynatıcıya iletebilirsiniz.
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
işlevini çağırarak geçerli manifest dosyasını alabilirsiniz.
HLS için döndürülen nesneyi HlsManifest
olarak yayınlamanız gerekir. İlgili içeriği oluşturmak için kullanılan
Player.Listener
için onTimelineChanged
geri çağırması her zaman
manifest yüklendi. 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'i bir uygulamanın,
manifest dosyası her yüklendiğinde bir işlem yapabilir.
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 özelleştirmenize olanak tanıyan birden fazla yöntem sunar. Örnekler için Özelleştirme sayfasına bakın.
Yığınsız hazırlığı 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 yöntem, #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 ayrılmadan hazırlama özelliğini devre dışı bırakabilirsiniz. Bu
ExoPlayer'ın bir medya segmenti indirmesi gerektiğinden başlama süresini uzatacaktır
ek yolları keşfedeceksiniz ve tercih ettiğiniz e-posta adresini
altyazı parçalarını
oynatmanıza yardımcı olur.
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 kullanabileceğiniz belirli yönergeler vardır HLS içeriğinizi iyileştirmek için aşağıdaki adımları uygulayın. ExoPlayer makalesini inceleyebilirsiniz. Önemli noktalar şunlardır:
- Kesin segment sürelerini 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 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 canlı yayın penceresi sağlayın. Bir dakika veya daha uzun süre iyidir.