Sorunsuz Akış

ExoPlayer, FMP4 kapsayıcı biçimiyle SmoothStreaming'i destekler. Medya akışları demukslenmelidir. Yani video, ses ve metin, SmoothStreaming manifestindeki ayrı StreamIndex öğelerinde tanımlanmalıdır. İçerilen ses ve video örnek biçimlerinin de desteklenmesi gerekir (ayrıntılar için örnek biçimler bölümüne bakın).

Özellik Destekleniyor Yorumlar
Container'lar
FMP4 EVET Yalnızca ayrılmış akışlar
Altyazılar
TTML EVET FMP4'e yerleştirilmiş
İçerik koruma
PlayReady SL2000 EVET Yalnızca Android TV
Canlı oynatma
Normal canlı oynatma EVET
Common Media Client Data (CMCD) EVET Entegrasyon Kılavuzu

MediaItem kullanma

SmoothStreaming akışı oynatmak için SmoothStreaming modülünü kullanmanız gerekir.

Kotlin

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

Groovy

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

Ardından, SmoothStreaming manifest URI'si için bir MediaItem oluşturabilir ve bunu 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(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 değerini MediaItem.Builder öğesinin setMimeType parametresine iletebilirsiniz.

ExoPlayer, hem kullanılabilir 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 SsMediaSource 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 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();

Manifeste erişme

Player.getCurrentManifest yöntemini çağırarak mevcut manifesti alabilirsiniz. SmoothStreaming için döndürülen nesneyi SsManifest 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 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.
        }
      }
    });

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.