Sorunsuz Akış

ExoPlayer, SmoothStreaming'i FMP4 kapsayıcı biçimiyle destekler. Medya akışları ayrıştırılmalıdır. Diğer bir deyişle video, ses ve metin, SmoothStreaming manifest dosyasında farklı 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 tekilleştirilmiş akışlar
Kapalı altyazılar
TTML	EVET	FMP4'e yerleştirilmiş
İçerik koruması
PlayHazır SL2000	EVET	Yalnızca Android TV
Canlı oynatma
Düzenli canlı oynatma	EVET
Common Media Client Data (CMCD)	EVET	Entegrasyon Rehberi

MediaItem kullanma

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

Kotlin

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

Modern

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

Daha sonra, SmoothStreaming manifest URI'sı 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 bir şekilde belirtmek için MimeTypes.APPLICATION_SS / MediaItem.Builder öğesi için setMimeType ekleyebilirsiniz.

ExoPlayer, hem kullanılabilir bant genişliğini hem de cihaz özelliklerini dikkate alarak manifestte tanımlanan gösterimler arasında otomatik olarak uyum sağlar.

SsMediaSource'u Kullanma

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

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 geçerli manifesti alabilirsiniz. SmoothStreaming için döndürülen nesneyi SsManifest adresine yayınlamanız gerekir. Manifest her yüklendiğinde Player.Listener için onTimelineChanged geri çağırması da çağrılır. Bu durum, seç-izle içeriklerde bir kez, canlı içeriklerde de pek çok kez gerçekleşir. Aşağıdaki kod snippet'i, manifest dosyası her yüklendiğinde bir uygulamanın nasıl işlem yapabileceğini göstermektedir.

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 çeşitli yollar sunar. Örnekler için Özelleştirme sayfasına bakın.