ExoPlayer, birden fazla kapsayıcı biçimiyle HLS'yi destekler. İçerilen ses ve video örnek biçimlerinin de desteklenmesi gerekir (ayrıntılar için örnek biçimler bölümüne bakın). HLS içerik üreticilerinin, bu blog yayınında açıklandığı gibi yüksek kaliteli HLS yayınları oluşturmasını önemle tavsiye ederiz.
Özellik | Destekleniyor | Yorumlar |
---|---|---|
Container'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 koruma | ||
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 kontrolü | ||
Delta güncellemeleri | EVET | |
Oynatma listesinin yeniden yüklenmesini engelleme | EVET | |
Önceden yükleme ipuçlarının yüklenmesini engelleme | EVET | Tanımlanmamış uzunluklara sahip bayt aralıkları hariç |
Reklam ekleme | ||
Sunucu tarafından yönlendirilen reklam ekleme (Geçiş reklamları) | Kısmen | Yalnızca X-ASSET-URI ile VOD.
Canlı yayınlar ve
X-ASSET-LIST daha sonra eklenecektir. |
IMA sunucu tarafı ve istemci tarafı reklamları | EVET | Reklam ekleme kılavuzu |
Canlı oynatma | ||
Normal canlı oynatma | EVET | |
Düşük gecikmeli HLS (Apple) | EVET | |
Düşük gecikmeli HLS (Topluluk) | HAYIR | |
Ortak Medya İstemci Verileri CMCD | EVET | CMCD entegrasyon kılavuzu |
MediaItem kullanma
HLS akışını oynatmak için HLS modülünü kullanmanız gerekir.
Kotlin
implementation("androidx.media3:media3-exoplayer-hls:1.7.1")
Groovy
implementation "androidx.media3:media3-exoplayer-hls:1.7.1"
Ardından, HLS oynatma listesi URI'si için bir MediaItem
oluşturup oynatıcıya iletebilirsiniz.
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
değerini MediaItem.Builder
öğesinin setMimeType
bölümüne iletebilirsiniz.
Medya öğesinin URI'si, medya oynatma listesini veya çok değişkenli oynatma listesini gösterebilir. URI, birden fazla #EXT-X-STREAM-INF
etiketi bildiren çok varyantlı bir oynatma listesini işaret ediyorsa ExoPlayer, hem kullanılabilir 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 HlsMediaSource
oluşturabilir ve bunu MediaItem
yerine 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();
Manifeste erişme
Player.getCurrentManifest
yöntemini çağırarak mevcut manifesti alabilirsiniz.
HLS için döndürülen nesneyi HlsManifest
olarak yayınlamanız gerekir. Manifest yüklendiğinde onTimelineChanged
Player.Listener
geri çağırması da çağrılır. Bu işlem, isteğe bağlı içerikler için bir kez, canlı içerikler için ise birden çok kez gerçekleşebilir. Aşağıdaki kod snippet'inde, bir uygulamanın manifest yüklendiğinde nasıl işlem yapabileceği gösterilmektedir.
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.
}
}
});
Geçiş reklamları içeren HLS yayınlarını oynatma
HLS spesifikasyonu, bir medya oynatma listesine geçiş reklamı bilgilerini eklemek için kullanılabilecek HLS geçiş reklamlarını tanımlar. ExoPlayer, varsayılan olarak bu geçiş reklamlarını yok sayar. HlsInterstitialsAdsLoader
kullanılarak destek eklenebilir. Şartnamenin tüm özelliklerini başlangıçtan itibaren desteklemiyoruz. Yayınınız için destek eksikliği olduğunu düşünüyorsanız GitHub'da sorun bildirerek ve yayın URI'nizi göndererek bize bildirin. Böylece yayınınız için destek ekleyebiliriz.
Şarkı listesi API'siyle MediaItem
kullanma
HLS yayınlarını geçiş reklamlarıyla oynatmanın en kolay yolu, HlsInterstitialsAdsLoader.AdsMediaSourceFactory
ile bir ExoPlayer örneği oluşturmaktır.
Bu, HLS geçiş reklamlarını oynatmak için MediaItem
tabanlı oynatma listesi API'sinin Player
arayüzünde kullanılmasını sağlar.
Oyuncu örneği oluşturulurken MediaSource.Factory
ExoPlayer
oluşturucuya eklenebilir:
Kotlin
hlsInterstitialsAdsLoader = HlsInterstitialsAdsLoader(context)
// Create a MediaSource.Factory for HLS streams with interstitials.
var hlsMediaSourceFactory =
HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
hlsInterstitialsAdsLoader,
playerView,
DefaultMediaSourceFactory(context),
)
// Build player with interstitials media source factory
player =
ExoPlayer.Builder(context)
.setMediaSourceFactory(hlsMediaSourceFactory)
.build()
// Set the player on the ads loader.
hlsInterstitialsAdsLoader.setPlayer(player)
playerView.setPlayer(player)
Java
hlsInterstitialsAdsLoader = new HlsInterstitialsAdsLoader(context);
// Create a MediaSource.Factory for HLS streams with interstitials.
MediaSource.Factory hlsMediaSourceFactory =
new HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
hlsInterstitialsAdsLoader, playerView, new DefaultMediaSourceFactory(context));
// Build player with interstitials media source factory
player =
new ExoPlayer.Builder(context)
.setMediaSourceFactory(hlsMediaSourceFactory)
.build();
// Set the player on the ads loader.
hlsInterstitialsAdsLoader.setPlayer(player);
playerView.setPlayer(player);
Bu tür bir oynatıcı kurulumunda, HLS geçiş reklamlarını oynatmak için oynatıcıda AdsConfiguration
ile bir medya öğesi ayarlamanız yeterlidir:
Kotlin
player.setMediaItem(
MediaItem.Builder()
.setUri("https://www.example.com/media.m3u8")
.setAdsConfiguration(
AdsConfiguration.Builder(Uri.parse("hls://interstitials"))
.setAdsId("ad-tag-0") // must be unique within playlist
.build())
.build())
player.prepare();
player.play();
Java
player.setMediaItem(
new MediaItem.Builder()
.setUri("https://www.example.com/media.m3u8")
.setAdsConfiguration(
new AdsConfiguration.Builder(Uri.parse("hls://interstitials"))
.setAdsId("ad-tag-0") // must be unique within playlist
.build())
.build());
player.prepare();
player.play();
Medya kaynağına dayalı API'yi kullanma
Alternatif olarak, ExoPlayer örneği varsayılan medya kaynağı fabrikasını geçersiz kılmadan da oluşturulabilir. Uygulama, geçiş reklamlarını desteklemek için HlsInterstitialsAdsLoader.AdsMediaSourceFactory
kullanarak doğrudan MediaSource
oluşturabilir ve medya kaynağına dayalı oynatma listesi API'sini kullanarak ExoPlayer'a sağlayabilir:
Kotlin
hlsInterstitialsAdsLoader = HlsInterstitialsAdsLoader(context)
// Create a MediaSource.Factory for HLS streams with interstitials.
var hlsMediaSourceFactory =
HlsInterstitialsAdsLoader.AdsMediaSourceFactory(hlsInterstitialsAdsLoader, playerView, context)
// Build player with default media source factory.
player = new ExoPlayer.Builder(context).build();
// Create an media source from an HLS media item with ads configuration.
val mediaSource =
hlsMediaSourceFactory.createMediaSource(
MediaItem.Builder()
.setUri("https://www.example.com/media.m3u8")
.setAdsConfiguration(
MediaItem.AdsConfiguration.Builder(Uri.parse("hls://interstitials"))
.setAdsId("ad-tag-0")
.build()
)
.build()
)
// Set the media source on the player.
player.setMediaSource(mediaSource)
player.prepare()
player.play()
Java
HlsInterstitialsAdsLoader hlsInterstitialsAdsLoader = new HlsInterstitialsAdsLoader(context);
// Create a MediaSource.Factory for HLS streams with interstitials.
MediaSource.Factory hlsMediaSourceFactory =
new HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
hlsInterstitialsAdsLoader, playerView, context);
// Build player with default media source factory.
player = new ExoPlayer.Builder(context).build();
// Create an media source from an HLS media item with ads configuration.
MediaSource mediaSource =
hlsMediaSourceFactory.createMediaSource(
new MediaItem.Builder()
.setUri("https://www.example.com/media.m3u8")
.setAdsConfiguration(
new MediaItem.AdsConfiguration.Builder(Uri.parse("hls://interstitials"))
.setAdsId("ad-tag-0")
.build())
.build());
// Set the media source on the player.
exoPlayer.setMediaSource(mediaSource);
exoPlayer.prepare();
exoPlayer.play();
Reklam etkinliklerini dinleme
HLS geçiş reklamlarının oynatılmasıyla ilgili durum değişiklikleri hakkındaki etkinlikleri izlemek için Listener
, HlsInterstitialsAdsLoader
'ye eklenebilir. Bu sayede bir uygulama veya SDK, oynatılan reklamları, yüklenen öğe listelerini, hazırlanan reklam medyası kaynaklarını izleyebilir ya da öğe listesi yükleme ve reklam hazırlama hatalarını algılayabilir. Ayrıca, reklam medya kaynakları tarafından yayınlanan meta veriler, ayrıntılı reklam oynatma doğrulaması için veya reklam oynatma ilerleme durumunu izlemek için alınabilir.
Kotlin
class AdsLoaderListener : HlsInterstitialsAdsLoader.Listener {
override fun onStart(mediaItem: MediaItem, adsId: Any, adViewProvider: AdViewProvider) {
// Do something when HLS media item with interstitials is started.
}
override fun onMetadata(
mediaItem: MediaItem,
adsId: Any,
adGroupIndex: Int,
adIndexInAdGroup: Int,
metadata: Metadata,
) {
// Do something with metadata that is emitted by the ad media source of the given ad.
}
override fun onAdCompleted(
mediaItem: MediaItem,
adsId: Any,
adGroupIndex: Int,
adIndexInAdGroup: Int,
) {
// Do something when ad completed playback.
}
// ... See JavaDoc for further callbacks of HlsInterstitialsAdsLoader.Listener.
override fun onStop(mediaItem: MediaItem, adsId: Any, adPlaybackState: AdPlaybackState) {
// Do something with the resulting ad playback state when stopped.
}
}
Java
private class AdsLoaderListener
implements HlsInterstitialsAdsLoader.Listener {
// implement HlsInterstitialsAdsLoader.Listener
@Override
public void onStart(MediaItem mediaItem, Object adsId, AdViewProvider adViewProvider) {
// Do something when HLS media item with interstitials is started.
}
@Override
public void onMetadata(
MediaItem mediaItem,
Object adsId,
int adGroupIndex,
int adIndexInAdGroup,
Metadata metadata) {
// Do something with metadata that is emitted by the ad media source of the given ad.
}
@Override
public void onAdCompleted(
MediaItem mediaItem, Object adsId, int adGroupIndex, int adIndexInAdGroup) {
// Do something when ad completed playback.
}
// ... See JavaDoc for further callbacks
@Override
public void onStop(MediaItem mediaItem, Object adsId, AdPlaybackState adPlaybackState) {
// Do something with the resulting ad playback state when stopped.
}
}
Kullanılabilir tüm geri çağırmaların ayrıntılı belgeleri için JavaDoc of HlsInterstitialsAdsLoader.Listener
'a bakın.
Daha sonra dinleyici, reklam yükleyiciye eklenebilir:
Kotlin
var listener = AdsLoaderListener();
// Add the listener to the ads loader to receive ad loader events.
hlsInterstitialsAdsLoader.addListener(listener);
Java
AdsLoaderListener listener = new AdsLoaderListener();
// Add the listener to the ads loader to receive ad loader events.
hlsInterstitialsAdsLoader.addListener(listener);
HlsInterstitialsAdsLoader
yaşam döngüsü
HlsInterstitialsAdsLoader
veya HlsInterstitialsAdsLoader.AdsMediaSourceFactory
örneği, reklamların yüklenmesi gereken birden fazla medya kaynağı oluşturan birden fazla oynatıcı örneği için yeniden kullanılabilir.
Örneğin, Activity
öğesinin onCreate
yönteminde bir örnek oluşturulabilir ve ardından birden fazla oynatıcı örneği için yeniden kullanılabilir. Bu özellik, aynı anda tek bir oynatıcı örneği tarafından kullanıldığı sürece çalışır. Bu, uygulamanın arka plana alındığı, oynatıcı örneğinin yok edildiği ve ardından uygulama tekrar ön plana alındığında yeni bir örneğin oluşturulduğu yaygın kullanım alanı için yararlıdır.
Kotlin
// Create the ads loader instance (for example onCreate).
hlsInterstitialsAdsLoader = HlsInterstitialsAdsLoader(context);
// Build a player and set it on the ads loader (for example onStart).
player = ExoPlayer.Builder(context).build();
hlsInterstitialsAdsLoader.setPlayer(player);
// Release the player and unset it on the ads loader (for example onStop).
player.release();
hlsInterstitialsAdsLoader.setPlayer(null);
// Build another player and set it on the ads loader (for example onStart).
player = ExoPlayer.Builder(context).build();
hlsInterstitialsAdsLoader.setPlayer(player);
// Release the player and unset it on the ads loader (for example onStop).
player.release();
hlsInterstitialsAdsLoader.setPlayer(null);
// Release the ads loader when not used anymore (for example onDestroy).
hlsInterstitialsAdsLoader.release();
Java
// Create the ads loader instance (for example onCreate).
hlsInterstitialsAdsLoader = new HlsInterstitialsAdsLoader(context);
// Build a player and set it on the ads loader (for example onStart).
player = new ExoPlayer.Builder(context).build();
hlsInterstitialsAdsLoader.setPlayer(player);
// Release the player and unset it on the ads loader (for example onStop).
player.release();
hlsInterstitialsAdsLoader.setPlayer(null);
// Build another player and set it on the ads loader (for example onStart).
player = new ExoPlayer.Builder(context).build();
hlsInterstitialsAdsLoader.setPlayer(player);
// Release the player and unset it on the ads loader (for example onStop).
player.release();
hlsInterstitialsAdsLoader.setPlayer(null);
// Release the ads loader when not used anymore (for example onDestroy).
hlsInterstitialsAdsLoader.release();
Genel olarak, reklam yükleyiciye bir sonraki oynatıcı örneğini ayarlamadan önce eski oynatıcı örneğini serbest bıraktığınızdan emin olun. Reklam yükleyici yayınlandıktan sonra reklam yükleyici artık kullanılamaz.
Oynatmayı özelleştirme
ExoPlayer, oynatma deneyimini uygulamanızın ihtiyaçlarına göre uyarlamanız için birden fazla yol sunar. Örnekler için Özelleştirme sayfasına bakın.
Parçasız hazırlamayı devre dışı bırakma
ExoPlayer, varsayılan olarak parçasız hazırlama kullanır. Bu, ExoPlayer'ın akışı hazırlamak için yalnızca çok değişkenli oynatma listesindeki bilgileri kullanacağı anlamına gelir. Bu durum, #EXT-X-STREAM-INF
etiketleri CODECS
özelliğini içeriyorsa geçerlidir.
Medya segmentleriniz, çok formatlı oynatma listesinde #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS
etiketiyle belirtilmeyen, çoklu hale getirilmiş altyazı parçaları içeriyorsa bu özelliği devre dışı bırakmanız gerekebilir. Aksi takdirde bu altyazı parçaları algılanmaz ve oynatılmaz. Aşağıdaki snippet'te gösterildiği gibi, HlsMediaSource.Factory
içinde parçasız hazırlamayı devre dışı bırakabilirsiniz. ExoPlayer'ın bu ek parçaları bulmak için bir medya segmenti indirmesi gerektiğinden bu işlemin başlatma süresini uzatacağını ve bunun yerine çok değişkenli oynatma listesinde altyazı parçalarını bildirmenin tercih edileceğini unutmayın.
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. Ayrıntılı açıklama için ExoPlayer'da HLS oynatma hakkındaki Medium yayınımızı okuyun. Temel noktalar şunlardır:
- Tam 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 yerine ayrılmış akışlar tercih edilir.
- Çok varyantlı oynatma listesine ekleyebileceğiniz tüm bilgileri 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üreler idealdir.