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 üreticilerinin, bu blog yayınında açıklandığı gibi yüksek kaliteli HLS yayınları oluşturmasını önemle tavsiye ederiz.

Özellik Destekleniyor Yorumlar
Kapsayıcılar
MPEG-TS EVET
FMP4/CMAF EVET
ADTS (AAC) EVET
MP3 EVET
Altyazılar / çevrilmiş 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ç
Reklam ekleme
Sunucu yönlendirmeli reklam ekleme (geçiş reklamları) Kısmen Yalnızca X-ASSET-URI ile VOD. Canlı yayınlar ve X-ASSET-LIST daha sonra eklenecek.
IMA sunucu tarafı ve istemci tarafı reklamlar EVET Reklam ekleme rehberi
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'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.6.0")

Groovy

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

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'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.

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'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.

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

HLS yayınlarını geçiş reklamlarıyla oynatma

HLS spesifikasyonu, medya oynatma listesine geçiş reklamı bilgileri eklemek için kullanılabilecek HLS geçiş reklamlarını tanımlar. ExoPlayer varsayılan olarak bu geçiş reklamlarını yoksayar. HlsInterstitialsAdsLoader kullanılarak destek eklenebilir. Spesifikasyonun tüm özellikleri başlangıçta desteklenmez. Canlı yayınınız için destek alamadığınızda GitHub'da sorun kaydı açarak bize bildirin ve canlı yayınınızın URI'sini gönderin. Böylece canlı 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 uygun yolu, HlsInterstitialsAdsLoader.AdsMediaSourceFactory ile bir ExoPlayer örneği oluşturmaktır. Bu sayede, HLS geçiş reklamlarını oynatmak için Player arayüzünün MediaItem tabanlı oynatma listesi API'sini kullanabilirsiniz.

Oyuncu örneği oluşturulurken ExoPlayer öğesinin MediaSource.Factory özelliği 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 içeren bir medya öğesi ayarlamak 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. Uygulamalar, geçiş reklamlarını desteklemek için doğrudan HlsInterstitialsAdsLoader.AdsMediaSourceFactory kullanarak MediaSource oluşturup medya kaynağı tabanlı 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şiklikleriyle ilgili etkinlikleri izlemek için HlsInterstitialsAdsLoader'ye bir Listener eklenebilir. Bu sayede uygulama veya SDK, oynatılan reklamları, yüklenen öğe listelerini, hazırlanan reklam medya 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.
  }
}

Mevcut tüm geri çağırmaların ayrıntılı dokümanları için HlsInterstitialsAdsLoader.Listener'un JavaDoc'una bakın.

Dinleyici daha sonra 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, bir Activity nesnesinin onCreate yönteminde bir örnek oluşturulabilir ve daha sonra birden fazla oynatıcı örneği için yeniden kullanılabilir. Bu, aynı anda tek bir oynatıcı örneği tarafından kullanıldığı sürece çalışır. Bu, uygulama arka plana alındığında oynatıcı örneğinin kaldırıldığı ve 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();

Genellikle, reklam yükleyicide 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.

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 ayrılmadan 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şlangıç süresini artıracağını unutmayın. Bunun yerine, altyazı parçalarını çok değişkenli oynatma listesinde belirtmeniz önerilir.

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çerikleri oluşturma

ExoPlayer'dan en iyi şekilde yararlanmak için HLS içeriğinizi iyileştirmek üzere uygulayabileceğiniz belirli kurallar 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 değişkenli 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.