Sorunsuz Akış

ExoPlayer, FMP4 kapsayıcı biçimiyle SmoothStreaming'i destekler. Medya akışları, video, ses ve metnin SmoothStreaming manifest'indeki farklı StreamIndex öğelerinde tanımlanması gerektiği anlamına gelen bir şekilde birleştirilmelidir. İçerdiği ses ve video örnek biçimleri de desteklenmelidir (Ayrıntılar için örnek biçimleri bölümüne bakın).

Özellik Destekleniyor Yorumlar
Kapsayıcılar
FMP4 EVET Yalnızca demuxed akışlar
Altyazılar
TTML EVET FMP4'e yerleştirilmiş
İçerik koruması
PlayReady SL2000 EVET Yalnızca Android TV
Canlı oynatma
Normal canlı oynatma EVET
Ortak Medya İstemcisi Verileri (CMCD) EVET Entegrasyon Kılavuzu

MediaItem'i kullanma

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

Kotlin

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

Groovy

implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.4.1"

Daha sonra, SmoothStreaming manifest URI'si için bir MediaItem oluşturup 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(ssUri))
// 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(ssUri));
// Prepare the player.
player.prepare();

URI'niz .ism/Manifest ile bitmiyorsa içeriğin türünü açıkça belirtmek için MimeTypes.APPLICATION_SS'yi MediaItem.Builder'ın setMimeType alanına iletebilirsiniz.

ExoPlayer, hem mevcut bant genişliğini hem de cihaz özelliklerini dikkate alarak manifest dosyasında tanımlanan temsiller arasında otomatik olarak uyum sağlar.

SsMediaSource'ı kullanma

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

Kotlin

// Create a data source factory.
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a SmoothStreaming media source pointing to a manifest uri.
val mediaSource: MediaSource =
  SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri))
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media source to be played.
player.setMediaSource(mediaSource)
// Prepare the player.
player.prepare()

Java

// Create a data source factory.
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a SmoothStreaming media source pointing to a manifest uri.
MediaSource mediaSource =
    new SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri));
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media source to be played.
player.setMediaSource(mediaSource);
// Prepare the player.
player.prepare();

Manifest'e erişim

Player.getCurrentManifest işlevini çağırarak geçerli manifest dosyasını alabilirsiniz. SmoothStreaming için döndürülen nesneyi SsManifest hedefine 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 SsManifest) {
        // 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) {
          SsManifest ssManifest = (SsManifest) manifest;
          // Do something with the manifest.
        }
      }
    });

Oynatma ayarlarını ö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.