สตรีมมิงแบบสด

ExoPlayer เล่นไลฟ์สดแบบปรับอัตโนมัติส่วนใหญ่ได้ทันทีโดยไม่ต้องมีการกำหนดค่าพิเศษใดๆ ดูรายละเอียดเพิ่มเติมได้ที่หน้ารูปแบบที่รองรับ

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

การตรวจจับและตรวจสอบการเล่นแบบสด

ทุกครั้งที่มีการอัปเดตหน้าต่างแสดงผลแบบสด อินสแตนซ์ Player.Listener ที่ลงทะเบียนไว้จะได้รับเหตุการณ์ onTimelineChanged คุณสามารถดูรายละเอียดเกี่ยวกับการเล่นแบบสดในปัจจุบันได้โดยการค้นหาเมธอด Player และ Timeline.Window ต่างๆ ตามที่ระบุไว้ในภายหลังและแสดงในรูปภาพต่อไปนี้

API การค้นหาหน้าต่างแบบเรียลไทม์
รูปที่ 1 หน้าต่างไลฟ์สด
  • 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.liveConfiguration
    • Window.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: ระบบจะเพิ่มค่านี้ลงในออฟเซ็ตการถ่ายทอดสดเป้าหมายเมื่อใดก็ตามที่เกิดการบัฟเฟอร์ซ้ำ เพื่อดำเนินการอย่างระมัดระวังมากขึ้น คุณปิดใช้ฟีเจอร์นี้ได้โดยตั้งค่าเป็น 0
  • minPossibleLiveOffsetSmoothingFactor: ปัจจัยการปรับให้เรียบแบบเอ็กซ์โพเนนเชียลที่ใช้เพื่อติดตามออฟเซ็ตการถ่ายทอดสดขั้นต่ำที่เป็นไปได้โดยอิงตามสื่อที่บัฟเฟอร์อยู่ในปัจจุบัน ค่าที่ใกล้เคียงกับ 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
  }
}