ใน ExoPlayer สื่อทุกรายการจะแสดงด้วย MediaItem อย่างไรก็ตาม ในทางเทคนิคแล้ว เพลเยอร์ต้องใช้ MediaSource อินสแตนซ์เพื่อเล่นเนื้อหา เครื่องเล่นจะสร้างรายการเหล่านี้จากรายการสื่อโดยใช้ MediaSource.Factory
โดยค่าเริ่มต้น โปรแกรมเล่นจะใช้ DefaultMediaSourceFactory ซึ่งสามารถสร้างอินสแตนซ์ของการติดตั้งใช้งานเนื้อหา MediaSource ต่อไปนี้
DashMediaSourceสำหรับ DASHSsMediaSourceสำหรับ SmoothStreamingHlsMediaSourceสำหรับ HLSProgressiveMediaSourceสำหรับไฟล์สื่อปกติRtspMediaSourceสำหรับ RTSP
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: ขยายแหล่งที่มาของสื่อด้วยความสามารถในการแทรกโฆษณาฝั่งเซิร์ฟเวอร์ ดูรายละเอียดได้ในคู่มือการแทรกโฆษณา