Sumber media

Di ExoPlayer, setiap media diwakili oleh MediaItem. Namun, secara internal, pemutar memerlukan instance MediaSource untuk memutar konten. Pemutar membuatnya dari item media menggunakan MediaSource.Factory.

Secara default, pemutar menggunakan DefaultMediaSourceFactory, yang dapat membuat instance penerapan konten MediaSource berikut:

DefaultMediaSourceFactory juga dapat membuat sumber media yang lebih kompleks, bergantung pada properti item media yang sesuai. Hal ini dijelaskan lebih mendetail di Halaman item media.

Untuk aplikasi yang memerlukan penyiapan sumber media yang tidak didukung oleh konfigurasi default pemutar, ada beberapa opsi untuk penyesuaian.

Menyesuaikan pembuatan sumber media

Saat membangun pemutar, MediaSource.Factory dapat disisipkan. Misalnya, jika aplikasi ingin menyisipkan iklan dan menggunakan CacheDataSource.Factory untuk mendukung penyiapan cache, instance DefaultMediaSourceFactory dapat dikonfigurasi agar sesuai dengan persyaratan ini dan disisipkan selama pembuatan pemutar:

Kotlin

val mediaSourceFactory: MediaSource.Factory =
  DefaultMediaSourceFactory(context)
    .setDataSourceFactory(cacheDataSourceFactory)
    .setLocalAdInsertionComponents(adsLoaderProvider, playerView)
val player = ExoPlayer.Builder(context).setMediaSourceFactory(mediaSourceFactory).build()
MediaSources.kt

Java

MediaSource.Factory mediaSourceFactory =
    new DefaultMediaSourceFactory(context)
        .setDataSourceFactory(cacheDataSourceFactory)
        .setLocalAdInsertionComponents(adsLoaderProvider, /* adViewProvider= */ playerView);
ExoPlayer player =
    new ExoPlayer.Builder(context).setMediaSourceFactory(mediaSourceFactory).build();
MediaSources.java

DefaultMediaSourceFactory JavaDoc menjelaskan opsi yang tersedia secara lebih mendetail.

Anda juga dapat menyuntikkan implementasi MediaSource.Factory kustom, misalnya untuk mendukung pembuatan jenis sumber media kustom. createMediaSource(MediaItem) pabrik akan dipanggil untuk membuat sumber media bagi setiap item media yang ditambahkan ke playlist.

API playlist berbasis sumber media

Antarmuka ExoPlayer menentukan metode playlist tambahan yang menerima sumber media, bukan item media. Hal ini memungkinkan untuk melewati MediaSource.Factory internal pemain dan meneruskan instance sumber media ke pemutar secara langsung:

Kotlin

// Set a list of media sources as initial playlist.
exoPlayer.setMediaSources(listOfMediaSources)
// Add a single media source.
exoPlayer.addMediaSource(anotherMediaSource)

// Can be combined with the media item API.
exoPlayer.addMediaItem(/* index= */ 3, MediaItem.fromUri(videoUri))

exoPlayer.prepare()
exoPlayer.play()
MediaSources.kt

Java

// Set a list of media sources as initial playlist.
exoPlayer.setMediaSources(listOfMediaSources);
// Add a single media source.
exoPlayer.addMediaSource(anotherMediaSource);

// Can be combined with the media item API.
exoPlayer.addMediaItem(/* index= */ 3, MediaItem.fromUri(videoUri));

exoPlayer.prepare();
exoPlayer.play();
MediaSources.java

Komposisi sumber media lanjutan

ExoPlayer menyediakan beberapa implementasi MediaSource untuk mengubah dan menyusun instance MediaSource lainnya. Hal ini paling berguna jika beberapa penyesuaian harus digabungkan dan tidak ada jalur penyiapan yang lebih sederhana yang memadai.

  • ClippingMediaSource: Memungkinkan klip media ke rentang stempel waktu tertentu. Jika ini satu-satunya modifikasi, sebaiknya gunakan MediaItem.ClippingConfiguration.
  • FilteringMediaSource: Memfilter trek yang tersedia ke jenis yang ditentukan, misalnya, hanya mengekspos trek video dari file yang berisi audio dan video. Jika ini satu-satunya modifikasi, sebaiknya gunakan parameter pemilihan trek.
  • MergingMediaSource: Menggabungkan beberapa sumber media untuk diputar secara paralel. Dalam hampir semua kasus, sebaiknya panggil konstruktor dengan adjustPeriodTimeOffsets dan clipDurations disetel ke benar (true) untuk memastikan semua sumber dimulai dan diakhiri pada waktu yang sama. Jika modifikasi ini dilakukan untuk menambahkan subtitel yang di-sideload, sebaiknya gunakan MediaItem.SubtitleConfiguration.
  • ConcatenatingMediaSource2: Menggabungkan beberapa sumber media untuk diputar secara berurutan. Struktur media yang terlihat oleh pengguna menampilkan satu Timeline.Window, yang berarti terlihat seperti satu item. Jika modifikasi ini dilakukan untuk memutar beberapa item yang seharusnya tidak terlihat seperti satu item, sebaiknya gunakan metode playlist API seperti Player.addMediaItem.
  • SilenceMediaSource: Membuat keheningan selama durasi tertentu yang berguna untuk mengisi kesenjangan.
  • AdsMediaSource: Memperluas sumber media dengan kemampuan penyisipan iklan sisi klien. Lihat panduan penyisipan iklan untuk mengetahui detailnya.
  • ServerSideAdInsertionMediaSource: Memperluas sumber media dengan kemampuan penyisipan iklan sisi server. Lihat panduan penyisipan iklan untuk mengetahui detailnya.