Sorunsuz Akış

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

Özellik Destekleniyor Yorumlar
Kapsayıcılar
FMP4 EVET Yalnızca ayrıştırılmış 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 İstemci Verileri (CMCD) EVET Entegrasyon Kılavuzu

MediaItem'ı kullanma

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

Kotlin

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

Modern

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

Ardından, SmoothStreaming manifest 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(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'nız .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 manifestte 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 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 işlevini çağırarak mevcut manifesti alabilirsiniz. SmoothStreaming için döndürülen nesneyi SsManifest olarak yayınlamanız gerekir. Player.Listener öğesinin onTimelineChanged geri çağırma işlevi, manifest her yüklendiğinde de çağrılır. Bu durum, seç-izle 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, manifest yüklendiğinde bir uygulamanın nasıl işlem yapabileceğini gösterir.

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 yöntem sunar. Örnekler için Özelleştirme sayfası'na bakın.