SmoothStreaming

ExoPlayer mendukung SmoothStreaming dengan format penampung FMP4. Streaming media harus didemux, yang berarti video, audio, dan teks harus ditentukan dalam elemen StreamIndex yang berbeda dalam manifes SmoothStreaming. Format sampel audio dan video yang disertakan juga harus didukung (lihat bagian format sampel untuk mengetahui detailnya).

Fitur	Didukung	Komentar
Container
FMP4	YA	Khusus streaming yang didemux
Teks tertutup/subtitel
TTML	YA	Disematkan dalam FMP4
Perlindungan konten
PlayReady SL2000	YA	Khusus Android TV
Pemutaran live
Pemutaran live reguler	YA
Common Media Client Data (CMCD)	YA	Panduan Integrasi

Menggunakan MediaItem

Untuk memutar streaming SmoothStreaming, Anda harus bergantung pada modul SmoothStreaming.

Kotlin

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

Groovy

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

Selanjutnya, Anda dapat membuat MediaItem untuk URI manifes SmoothStreaming dan meneruskannya ke pemutar.

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

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

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

Menggunakan SsMediaSource

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

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

Mengakses manifes

Anda dapat mengambil manifes saat ini dengan memanggil Player.getCurrentManifest. Untuk SmoothStreaming, Anda harus mentransmisikan objek yang ditampilkan ke SsManifest. Callback onTimelineChanged dari Player.Listener juga dipanggil setiap kali manifes dimuat. Hal ini akan terjadi sekali untuk konten on-demand dan mungkin beberapa kali untuk konten live. Cuplikan kode berikut menunjukkan cara aplikasi melakukan sesuatu setiap kali manifes dimuat.

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

Menyesuaikan pemutaran

ExoPlayer menyediakan beberapa cara bagi Anda untuk menyesuaikan pengalaman pemutaran dengan kebutuhan aplikasi. Lihat Halaman penyesuaian untuk mengetahui contohnya.