แหล่งที่มาของสื่อ

ใน ExoPlayer สื่อทุกรายการจะแสดงด้วย MediaItem อย่างไรก็ตาม ในทางเทคนิคแล้ว เพลเยอร์ต้องใช้ MediaSource อินสแตนซ์เพื่อเล่นเนื้อหา เครื่องเล่นจะสร้างรายการเหล่านี้จากรายการสื่อโดยใช้ MediaSource.Factory

โดยค่าเริ่มต้น โปรแกรมเล่นจะใช้ DefaultMediaSourceFactory ซึ่งสามารถสร้างอินสแตนซ์ของการติดตั้งใช้งานเนื้อหา MediaSource ต่อไปนี้

DefaultMediaSourceFactory ยังสามารถสร้างแหล่งที่มาของสื่อที่ซับซ้อนมากขึ้นได้ด้วย โดยขึ้นอยู่กับพร็อพเพอร์ตี้ของรายการสื่อที่เกี่ยวข้อง ซึ่งอธิบายไว้อย่างละเอียดในหน้ารายการสื่อ

สำหรับแอปที่ต้องมีการตั้งค่าแหล่งที่มาของสื่อซึ่งการกำหนดค่าเริ่มต้นของเพลเยอร์ไม่รองรับ จะมีตัวเลือกการปรับแต่งหลายรายการ

การปรับแต่งการสร้างแหล่งที่มาของสื่อ

เมื่อสร้างเพลเยอร์ คุณสามารถแทรก MediaSource.Factory ได้ ตัวอย่างเช่น หากแอปต้องการแทรกโฆษณาและใช้ CacheDataSource.Factory เพื่อรองรับ การแคช คุณสามารถกำหนดค่าอินสแตนซ์ของ DefaultMediaSourceFactory ให้ตรงกับ ข้อกำหนดเหล่านี้และแทรกระหว่างการสร้างเพลเยอร์ได้ ดังนี้

Kotlin

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

Java

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

DefaultMediaSourceFactory JavaDoc จะอธิบายตัวเลือกที่มีให้ใช้งานโดยละเอียด

นอกจากนี้ คุณยังแทรกการติดตั้งใช้งาน MediaSource.Factory ที่กำหนดเองได้ด้วย เช่น เพื่อรองรับการสร้างประเภทแหล่งที่มาของสื่อที่กำหนดเอง ระบบจะเรียกใช้ createMediaSource(MediaItem) ของโรงงานเพื่อสร้างแหล่งที่มาของสื่อสำหรับรายการสื่อแต่ละรายการที่เพิ่มลงในเพลย์ลิสต์

API เพลย์ลิสต์ตามแหล่งที่มาของสื่อ

อินเทอร์เฟซ ExoPlayer จะกำหนดเมธอดเพลย์ลิสต์เพิ่มเติมที่ยอมรับแหล่งที่มาของสื่อแทนรายการสื่อ ซึ่งทำให้สามารถข้าม MediaSource.Factory ภายในของเพลเยอร์และส่งอินสแตนซ์แหล่งที่มาของสื่อไปยังเพลเยอร์ได้โดยตรง ดังนี้

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

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

องค์ประกอบแหล่งที่มาของสื่อขั้นสูง

ExoPlayer มีการติดตั้งใช้งาน MediaSource หลายรายการเพื่อแก้ไขและเขียนอินสแตนซ์ MediaSource อื่นๆ ซึ่งจะมีประโยชน์มากที่สุดในกรณีที่ต้องรวมการปรับแต่งหลายรายการเข้าด้วยกัน และเส้นทางการตั้งค่าที่ง่ายกว่านั้นไม่เพียงพอ

  • ClippingMediaSource: อนุญาตให้ตัดคลิปสื่อตามช่วงการประทับเวลาที่ระบุ หากนี่เป็นการแก้ไขเพียงอย่างเดียว เราขอแนะนำให้ใช้ MediaItem.ClippingConfiguration แทน
  • FilteringMediaSource: กรองแทร็กที่ใช้ได้ตามประเภทที่ระบุ เช่น แสดงเฉพาะแทร็กวิดีโอจากไฟล์ที่มีทั้งเสียงและวิดีโอ หากนี่เป็นการแก้ไขเพียงอย่างเดียว เราขอแนะนำให้ใช้พารามิเตอร์การเลือกแทร็กแทน
  • MergingMediaSource: รวมแหล่งที่มาของสื่อหลายแหล่งเพื่อเล่นพร้อมกัน ในเกือบทุกกรณี ขอแนะนำให้เรียกใช้คอนสตรัคเตอร์โดยตั้งค่า adjustPeriodTimeOffsets และ clipDurations เป็น "จริง" เพื่อให้แหล่งที่มาทั้งหมดเริ่มต้นและสิ้นสุดพร้อมกัน หากการแก้ไขนี้ทำเพื่อเพิ่มคำบรรยายที่โหลดจากภายนอก ขอแนะนำให้ใช้ MediaItem.SubtitleConfiguration แทน
  • ConcatenatingMediaSource2: รวมแหล่งที่มาของสื่อหลายแหล่งเพื่อเล่นติดต่อกัน โครงสร้างสื่อที่ผู้ใช้มองเห็นจะแสดง Timeline.Window รายการเดียว ซึ่งหมายความว่าจะมีลักษณะเหมือนรายการเดียว หากการแก้ไขนี้ทำขึ้นเพื่อเล่นหลายรายการที่ไม่ได้มีลักษณะเหมือนรายการเดียว คุณควรใช้วิธีการของ playlist API เช่น Player.addMediaItem แทน
  • SilenceMediaSource: สร้างความเงียบตามระยะเวลาที่ระบุ ซึ่งมีประโยชน์ในการเติมช่องว่าง
  • AdsMediaSource: ขยายแหล่งที่มาของสื่อด้วยความสามารถในการแทรกโฆษณาฝั่งไคลเอ็นต์ ดูรายละเอียดได้ในคู่มือการแทรกโฆษณา
  • ServerSideAdInsertionMediaSource: ขยายแหล่งที่มาของสื่อด้วยความสามารถในการแทรกโฆษณาฝั่งเซิร์ฟเวอร์ ดูรายละเอียดได้ในคู่มือการแทรกโฆษณา