ExoPlayer เล่นไลฟ์สดแบบปรับอัตโนมัติส่วนใหญ่ได้ทันทีโดยไม่ต้องมีการกำหนดค่าพิเศษใดๆ ดูรายละเอียดเพิ่มเติมได้ที่หน้ารูปแบบที่รองรับ
ไลฟ์สดแบบปรับอัตโนมัติจะมีหน้าต่างของสื่อที่พร้อมใช้งานซึ่งอัปเดตเป็นระยะๆ เพื่อให้สอดคล้องกับเวลาปัจจุบันแบบเรียลไทม์ ซึ่งหมายความว่าตำแหน่งการเล่นจะอยู่ในหน้าต่างนี้เสมอ โดยในกรณีส่วนใหญ่จะใกล้เคียงกับเวลาปัจจุบันแบบเรียลไทม์ที่กำลังสร้างสตรีม ความแตกต่างระหว่างเวลาปัจจุบันแบบเรียลไทม์กับตำแหน่งการเล่นเรียกว่าออฟเซ็ตไลฟ์สด
การตรวจจับและตรวจสอบการเล่นแบบสด
ทุกครั้งที่มีการอัปเดตหน้าต่างแสดงผลแบบสด อินสแตนซ์ Player.Listener ที่ลงทะเบียนไว้จะได้รับเหตุการณ์ onTimelineChanged คุณสามารถดูรายละเอียดเกี่ยวกับการเล่นแบบสดในปัจจุบันได้โดยการค้นหาเมธอด Player และ Timeline.Window ต่างๆ ตามที่ระบุไว้ในภายหลังและแสดงในรูปภาพต่อไปนี้
Player.isCurrentWindowLiveระบุว่ารายการสื่อที่กำลังเล่นอยู่เป็นไลฟ์สดหรือไม่ ค่านี้จะยังคงเป็นจริงแม้ว่าไลฟ์สดจะสิ้นสุดลงแล้วก็ตามPlayer.isCurrentWindowDynamicระบุว่ารายการสื่อที่กำลังเล่นอยู่ยังคงได้รับการอัปเดตหรือไม่ ซึ่งมักเกิดขึ้นกับไลฟ์สดที่ยังไม่จบ โปรดทราบว่าในบางกรณี แฟล็กนี้ยังเป็นจริงสำหรับสตรีมที่ไม่ใช่ไลฟ์สดด้วยPlayer.getCurrentLiveOffsetแสดงผลออฟเซ็ตระหว่างเวลาจริงปัจจุบันกับตำแหน่งการเล่น (หากมี)Player.getDurationแสดงผลความยาวของหน้าต่างไลฟ์สดปัจจุบันPlayer.getCurrentPositionแสดงตำแหน่งการเล่นที่สัมพันธ์กับจุดเริ่มต้นของหน้าต่างไลฟ์สดPlayer.getCurrentMediaItemแสดงผลรายการสื่อปัจจุบัน โดยที่MediaItem.liveConfigurationมีการลบล้างที่แอปจัดเตรียมไว้สำหรับพารามิเตอร์การปรับออฟเซ็ตแบบสดและออฟเซ็ตแบบสดเป้าหมายPlayer.getCurrentTimelineแสดงผลโครงสร้างสื่อปัจจุบันในTimelineคุณสามารถดึงข้อมูลTimeline.Windowปัจจุบันได้จากTimelineโดยใช้Player.getCurrentMediaItemIndexและTimeline.getWindowในWindowให้ทำดังนี้Window.liveConfigurationมีพารามิเตอร์การปรับออฟเซ็ตไลฟ์สดและออฟเซ็ตไลฟ์สดเป้าหมาย ค่าเหล่านี้อิงตามข้อมูลในสื่อและการลบล้างที่แอปกำหนดไว้ในMediaItem.liveConfigurationWindow.windowStartTimeMsคือเวลาตั้งแต่ Unix Epoch ที่หน้าต่างการถ่ายทอดสดเริ่มต้นขึ้นWindow.getCurrentUnixTimeMsคือเวลาตั้งแต่ Unix Epoch ของเวลาปัจจุบันแบบเรียลไทม์ ค่านี้อาจได้รับการแก้ไขโดยความแตกต่างของนาฬิกาที่ทราบระหว่างเซิร์ฟเวอร์และไคลเอ็นต์Window.getDefaultPositionMsคือตำแหน่งในหน้าต่างไลฟ์สดที่โปรแกรมเล่นจะเริ่มเล่นโดยค่าเริ่มต้น
การกรอในไลฟ์สด
คุณสามารถกรอไปยังจุดใดก็ได้ภายในหน้าต่างไลฟ์สดโดยใช้ Player.seekTo ตำแหน่งการกรอที่ส่งจะสัมพันธ์กับจุดเริ่มต้นของหน้าต่างไลฟ์สด ตัวอย่างเช่น
seekTo(0) จะข้ามไปยังจุดเริ่มต้นของหน้าต่างไลฟ์สด เพลเยอร์จะพยายามรักษาออฟเซ็ตการถ่ายทอดสดให้เหมือนกับตำแหน่งที่กรอไปหลังจากกรอวิดีโอ
นอกจากนี้ หน้าต่างไลฟ์สดยังมีตำแหน่งเริ่มต้นที่ควรเริ่มเล่นด้วย โดยปกติแล้วตำแหน่งนี้จะอยู่ใกล้กับจุดสิ้นสุดของไลฟ์สด คุณสามารถกรอไปยังตำแหน่งเริ่มต้นได้โดยเรียกใช้ Player.seekToDefaultPosition
UI การเล่นไลฟ์สด
คอมโพเนนต์ UI เริ่มต้นของ ExoPlayer จะแสดงระยะเวลาของหน้าต่างไลฟ์สดและตำแหน่งการเล่นปัจจุบันภายในหน้าต่างนั้น ซึ่งหมายความว่าตำแหน่งจะดูเหมือนกระโดดย้อนกลับทุกครั้งที่มีการอัปเดตหน้าต่างแบบเรียลไทม์ หากต้องการลักษณะการทำงานที่แตกต่างออกไป เช่น การแสดงเวลา Unix Epoch หรือออฟเซ็ตปัจจุบัน คุณสามารถแยก PlayerControlView และแก้ไขให้เหมาะกับความต้องการของคุณได้
การกำหนดค่าพารามิเตอร์การเล่นไลฟ์สด
ExoPlayer ใช้พารามิเตอร์บางอย่างเพื่อควบคุมออฟเซ็ตของตำแหน่งการเล่นจากขอบไลฟ์สด และช่วงความเร็วในการเล่นที่ใช้ปรับออฟเซ็ตนี้ได้
ExoPlayer จะรับค่าสำหรับพารามิเตอร์เหล่านี้จาก 3 ตำแหน่ง โดยเรียงลำดับความสำคัญจากมากไปน้อย (ระบบจะใช้ค่าแรกที่พบ) ดังนี้
- ค่า
MediaItemต่อรายการที่ส่งไปยังMediaItem.Builder.setLiveConfiguration - ตั้งค่าเริ่มต้นส่วนกลางเมื่อวันที่
DefaultMediaSourceFactory - ค่าที่อ่านได้โดยตรงจากสื่อ
Kotlin
// Global settings. val player = ExoPlayer.Builder(context) .setMediaSourceFactory(DefaultMediaSourceFactory(context).setLiveTargetOffsetMs(5000)) .build() // Per MediaItem settings. val mediaItem = MediaItem.Builder() .setUri(mediaUri) .setLiveConfiguration( MediaItem.LiveConfiguration.Builder().setMaxPlaybackSpeed(1.02f).build() ) .build() player.setMediaItem(mediaItem)
Java
// Global settings. ExoPlayer player = new ExoPlayer.Builder(context) .setMediaSourceFactory( new DefaultMediaSourceFactory(context).setLiveTargetOffsetMs(5000)) .build(); // Per MediaItem settings. MediaItem mediaItem = new MediaItem.Builder() .setUri(mediaUri) .setLiveConfiguration( new MediaItem.LiveConfiguration.Builder().setMaxPlaybackSpeed(1.02f).build()) .build(); player.setMediaItem(mediaItem);
ค่าการกำหนดค่าที่ใช้ได้มีดังนี้
targetOffsetMs: ออฟเซ็ตเป้าหมายของการถ่ายทอดสด โปรแกรมเล่นจะพยายามเข้าใกล้ค่าออฟเซ็ตการถ่ายทอดสดนี้ในระหว่างการเล่นหากเป็นไปได้minOffsetMs: ออฟเซ็ตไลฟ์สดขั้นต่ำที่อนุญาต แม้ว่าจะปรับออฟเซ็ตให้เข้ากับสภาพเครือข่ายปัจจุบันแล้ว แต่เพลเยอร์จะไม่พยายามลดค่าให้ต่ำกว่าออฟเซ็ตนี้ในระหว่างการเล่นmaxOffsetMs: ออฟเซ็ตไลฟ์สูงสุดที่อนุญาต แม้ว่าจะปรับออฟเซ็ตให้เข้ากับสภาพเครือข่ายปัจจุบันแล้ว แต่เพลเยอร์จะไม่พยายามใช้ออฟเซ็ตเกินค่านี้ในระหว่างการเล่นminPlaybackSpeed: ความเร็วในการเล่นต่ำสุดที่โปรแกรมเล่นสามารถใช้เพื่อย้อนกลับเมื่อพยายามเข้าถึงออฟเซ็ตการถ่ายทอดสดเป้าหมายmaxPlaybackSpeed: ความเร็วในการเล่นสูงสุดที่โปรแกรมเล่นสามารถใช้เพื่อไล่ตามให้ทันเมื่อพยายามเข้าถึงออฟเซ็ตการถ่ายทอดสดเป้าหมาย
การปรับความเร็วในการเล่น
เมื่อเล่นไลฟ์สดที่มีเวลาในการตอบสนองต่ำ ExoPlayer จะปรับออฟเซ็ตไลฟ์โดยเปลี่ยนความเร็วในการเล่นเล็กน้อย เพลเยอร์จะพยายามจับคู่กับออฟเซ็ตเป้าหมายของการถ่ายทอดสดที่สื่อหรือแอปให้มา แต่ก็จะพยายามตอบสนองต่อสภาพเครือข่ายที่เปลี่ยนแปลงไปด้วย ตัวอย่างเช่น หากเกิดการบัฟเฟอร์ซ้ำระหว่างการเล่น เพลเยอร์จะเล่นช้าลงเล็กน้อยเพื่อเลื่อนออกจากจุดถ่ายทอดสด หากเครือข่ายมีความเสถียรเพียงพอที่จะรองรับการเล่นที่ใกล้เคียงกับเวลาจริงอีกครั้ง เพลเยอร์จะเร่งความเร็วในการเล่นเพื่อกลับไปยังออฟเซ็ตเป้าหมายของไลฟ์สด
หากไม่ต้องการให้ปรับความเร็วในการเล่นโดยอัตโนมัติ คุณสามารถปิดใช้ได้โดยตั้งค่าพร็อพเพอร์ตี้ minPlaybackSpeed และ maxPlaybackSpeed เป็น 1.0f
ในทำนองเดียวกัน คุณสามารถเปิดใช้สำหรับไลฟ์สดที่มีเวลาในการตอบสนองไม่ต่ำได้โดยตั้งค่าเหล่านี้เป็นค่าอื่นที่ไม่ใช่ 1.0f อย่างชัดเจน ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีตั้งค่าพร็อพเพอร์ตี้เหล่านี้ได้ในส่วนการกำหนดค่า
การปรับแต่งอัลกอริทึมการปรับความเร็วในการเล่น
หากเปิดใช้การปรับความเร็ว LivePlaybackSpeedControl จะกำหนดการปรับที่ทำ คุณสามารถใช้ LivePlaybackSpeedControl ที่กำหนดเอง หรือปรับแต่งการใช้งานเริ่มต้นซึ่งก็คือ DefaultLivePlaybackSpeedControl ได้ ในทั้ง 2 กรณี คุณสามารถตั้งค่าอินสแตนซ์ได้เมื่อสร้างเพลเยอร์ ดังนี้
Kotlin
val player = ExoPlayer.Builder(context) .setLivePlaybackSpeedControl( DefaultLivePlaybackSpeedControl.Builder().setFallbackMaxPlaybackSpeed(1.04f).build() ) .build()
Java
ExoPlayer player = new ExoPlayer.Builder(context) .setLivePlaybackSpeedControl( new DefaultLivePlaybackSpeedControl.Builder() .setFallbackMaxPlaybackSpeed(1.04f) .build()) .build();
พารามิเตอร์การปรับแต่งที่เกี่ยวข้องของ DefaultLivePlaybackSpeedControl มีดังนี้
fallbackMinPlaybackSpeedและfallbackMaxPlaybackSpeed: ความเร็วในการเล่นต่ำสุดและสูงสุดที่ใช้ในการปรับได้ หากทั้งสื่อและMediaItemที่แอปมีให้ไม่ได้กำหนดขีดจำกัดไว้proportionalControlFactor: ควบคุมความราบรื่นของการปรับความเร็ว ค่าที่สูงจะทำให้การปรับเปลี่ยนเกิดขึ้นอย่างกะทันหันและตอบสนองได้ดีขึ้น แต่ก็มีแนวโน้มที่จะได้ยินเสียงมากขึ้นด้วย ค่าที่น้อยลงจะทำให้การเปลี่ยนความเร็วราบรื่นขึ้น แต่จะช้าลงtargetLiveOffsetIncrementOnRebufferMs: ระบบจะเพิ่มค่านี้ลงในออฟเซ็ตการถ่ายทอดสดเป้าหมายเมื่อใดก็ตามที่เกิดการบัฟเฟอร์ซ้ำ เพื่อดำเนินการอย่างระมัดระวังมากขึ้น คุณปิดใช้ฟีเจอร์นี้ได้โดยตั้งค่าเป็น 0minPossibleLiveOffsetSmoothingFactor: ปัจจัยการปรับให้เรียบแบบเอ็กซ์โพเนนเชียลที่ใช้เพื่อติดตามออฟเซ็ตการถ่ายทอดสดขั้นต่ำที่เป็นไปได้โดยอิงตามสื่อที่บัฟเฟอร์อยู่ในปัจจุบัน ค่าที่ใกล้เคียงกับ 1 มากหมายความว่าการประมาณมีความระมัดระวังมากขึ้นและอาจใช้เวลานานขึ้นในการปรับให้เข้ากับสภาพเครือข่ายที่ดีขึ้น ในขณะที่ค่าที่ต่ำกว่าหมายความว่าการประมาณจะปรับเร็วขึ้นโดยมีความเสี่ยงสูงขึ้นที่จะเกิดการบัฟเฟอร์ซ้ำ
BehindLiveWindowException และ ERROR_CODE_BEHIND_LIVE_WINDOW
ตำแหน่งการเล่นอาจช้ากว่าหน้าต่างสด เช่น หากเพลเยอร์หยุดชั่วคราวหรือบัฟเฟอร์เป็นระยะเวลานานพอสมควร หากเกิดกรณีนี้ขึ้น การเล่นจะล้มเหลวและระบบจะรายงานข้อยกเว้นพร้อมรหัสข้อผิดพลาด ERROR_CODE_BEHIND_LIVE_WINDOW โดยใช้ Player.Listener.onPlayerError คุณอาจต้องจัดการข้อผิดพลาดดังกล่าวโดยกลับมาเล่นต่อที่ตำแหน่งเริ่มต้น PlayerActivity ของแอปสาธิตเป็นตัวอย่างของแนวทางนี้
Kotlin
override fun onPlayerError(error: PlaybackException) { if (error.errorCode == PlaybackException.ERROR_CODE_BEHIND_LIVE_WINDOW) { // Re-initialize player at the live edge. player.seekToDefaultPosition() player.prepare() } else { // Handle other errors } }
Java
@Override public void onPlayerError(PlaybackException error) { if (error.errorCode == PlaybackException.ERROR_CODE_BEHIND_LIVE_WINDOW) { // Re-initialize player at the live edge. player.seekToDefaultPosition(); player.prepare(); } else { // Handle other errors } }