SmoothStreaming

ExoPlayer mendukung SmoothStreaming dengan format container FMP4. Streaming media harus didemux, artinya video, audio, dan teks harus didefinisikan secara berbeda Elemen StreamIndex dalam manifes SmoothStreaming. Audio yang dimuat dan format sampel video juga harus didukung (lihat contoh format untuk mengetahui detailnya).

Menggunakan MediaItem

Untuk memutar streaming SmoothStreaming, Anda harus bergantung pada SmoothStreaming ruang lingkup modul ini.

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

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

Anda kemudian dapat membuat MediaItem untuk URI manifes SmoothStreaming dan meneruskannya kepada pemain.

// 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()

// 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();

Jika URI Anda tidak diakhiri dengan .ism/Manifest, Anda dapat meneruskan MimeTypes.APPLICATION_SS ke setMimeType dari MediaItem.Builder untuk secara eksplisit menunjukkan jenis kontennya.

ExoPlayer akan otomatis beradaptasi di antara representasi yang ditentukan dalam manifes, dengan mempertimbangkan {i>bandwidth <i} dan kemampuan perangkat yang tersedia.

Menggunakan SsMediaSource

Untuk opsi penyesuaian lainnya, Anda dapat membuat SsMediaSource dan meneruskannya langsung ke pemutar, bukan MediaItem.

// 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()

// 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();

Mengakses manifes

Anda bisa mengambil manifes saat ini dengan memanggil Player.getCurrentManifest. Untuk SmoothStreaming, Anda harus mentransmisikan objek yang ditampilkan ke SsManifest. Tujuan Callback onTimelineChanged dari Player.Listener juga dipanggil setiap kali manifes dimuat. Ini akan terjadi satu kali untuk konten on-demand dan mungkin berkali-kali untuk konten live streaming. Cuplikan kode berikut menunjukkan cara aplikasi bisa melakukan sesuatu kapan saja manifes dimuat.

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

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

Menyesuaikan pemutaran

ExoPlayer menyediakan beberapa cara bagi Anda untuk menyesuaikan pengalaman pemutaran dengan aplikasi Anda. Lihat halaman Penyesuaian untuk mengetahui contohnya.