สร้างและกำหนดค่า DefaultPreloadManager

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

เครื่องมือจัดการการโหลดล่วงหน้าที่อิงตามคลาสแอบสแตรกต์ BasePreloadManager ช่วยให้คุณจัดอันดับเนื้อหาตามเกณฑ์ที่เลือกได้ เอกสารนี้อธิบายวิธีใช้คลาสที่ได้มา DefaultPreloadManager ซึ่งรายการสื่อแต่ละรายการจะได้รับการจัดอันดับด้วยจำนวนเต็มที่แสดงตำแหน่งในรายการ (เช่น ตำแหน่งในภาพสไลด์วิดีโอ) เครื่องมือจัดการการโหลดล่วงหน้าจะจัดลําดับความสําคัญในการโหลดรายการตามความใกล้เคียงกับรายการที่ผู้ใช้กําลังเล่นอยู่ วิธีนี้จะช่วยให้รายการใหม่เริ่มเล่นได้ทันทีหากผู้ใช้เปลี่ยนไปดูรายการอื่น

การสร้างอินสแตนซ์ของ DefaultPreloadManager มี 3 ขั้นตอนดังนี้

• กำหนด TargetPreloadStatusControl ที่เครื่องมือจัดการการโหลดล่วงหน้าสามารถค้นหาเพื่อดูว่ารายการสื่อพร้อมโหลดหรือไม่และควรโหลดมากน้อยเพียงใด
• สร้าง Builder ซึ่งคุณจะใช้เพื่อสร้างเครื่องมือจัดการการโหลดล่วงหน้า และสร้างออบเจ็กต์ ExoPlayer ของแอป
• ใช้เครื่องมือสร้างเพื่อสร้างตัวจัดการการโหลดล่วงหน้าโดยเรียกใช้เมธอด build() ของเครื่องมือสร้าง

สร้างการควบคุมสถานะการโหลดล่วงหน้าเป้าหมาย

เมื่อสร้าง DefaultPreloadManager.Builder คุณจะต้องส่งออบเจ็กต์การควบคุมสถานะการโหลดล่วงหน้าเป้าหมายที่คุณกำหนด ออบเจ็กต์นี้ใช้อินเทอร์เฟซ TargetPreloadStatusControl เมื่อเครื่องมือจัดการการโหลดล่วงหน้าเตรียมพร้อมที่จะโหลดสื่อล่วงหน้า ระบบจะเรียกใช้เมธอด getTargetPreloadStatus() ของการควบคุมสถานะเพื่อพิจารณาว่าจะเตรียม โหลด หรือแคชเนื้อหาสำหรับรายการสื่อหรือไม่ การโหลดจะโหลดข้อมูลสื่อล่วงหน้าลงในบัฟเฟอร์ในหน่วยความจำของเพลเยอร์โดยตรง เพื่อให้พร้อมสำหรับการเล่นทันที ส่วนการแคชจะบันทึกข้อมูลสื่อลงในแคชดิสก์แบบถาวรเพื่อประหยัดหน่วยความจำของเพลเยอร์ การควบคุมสถานะสามารถตอบกลับด้วยรหัสสถานะอย่างใดอย่างหนึ่งต่อไปนี้

• STAGE_SPECIFIED_RANGE_LOADED: เครื่องมือจัดการการโหลดล่วงหน้าควรโหลดเนื้อหาจากตำแหน่งเริ่มต้นที่ระบุและตามระยะเวลาที่ระบุ (ระบุเป็นมิลลิวินาที) ลงในบัฟเฟอร์ในหน่วยความจำของเพลเยอร์
• STAGE_SPECIFIED_RANGE_CACHED: เครื่องมือจัดการการโหลดล่วงหน้าควรแคชเนื้อหาจากตำแหน่งเริ่มต้นที่ระบุและตามระยะเวลาที่ระบุ (ระบุเป็นมิลลิวินาที) ลงในแคชดิสก์
• STAGE_TRACKS_SELECTED: ตัวจัดการการโหลดล่วงหน้าควรโหลดและประมวลผลข้อมูลของแทร็กเนื้อหา แล้วเลือกแทร็ก เครื่องมือจัดการการโหลดล่วงหน้า ไม่ควรเริ่มโหลดเนื้อหาในตอนนี้
• STAGE_SOURCE_PREPARED: ตัวจัดการการโหลดล่วงหน้าควรเตรียมแหล่งที่มาของเนื้อหา ตัวอย่างเช่น หากข้อมูลเมตาของเนื้อหาอยู่ในไฟล์ Manifest แยกต่างหาก เครื่องมือจัดการการโหลดล่วงหน้าอาจดึงข้อมูลและแยกวิเคราะห์ไฟล์ Manifest นั้น
• null: ตัวจัดการการโหลดล่วงหน้าไม่ควรโหลดเนื้อหาหรือข้อมูลเมตาสำหรับรายการสื่อนั้น

คุณจะต้องมีกลยุทธ์ในการตัดสินใจว่าจะโหลดเนื้อหามากน้อยเพียงใดสำหรับรายการสื่อแต่ละรายการ ในตัวอย่างนี้ ระบบจะโหลดเนื้อหาเพิ่มเติมสำหรับรายการที่อยู่ใกล้กับรายการที่กำลังเล่นอยู่มากที่สุด หากผู้ใช้กำลังเล่นเนื้อหาที่มีดัชนี n ตัวควบคุมจะแสดงรหัสต่อไปนี้

• ดัชนี n+1 (รายการสื่อถัดไป): โหลด 3,000 มิลลิวินาที (3 วินาที) จากตำแหน่งเริ่มต้นเริ่มต้น
• ดัชนี n-1 (รายการสื่อก่อนหน้า): โหลด 1,000 มิลลิวินาที (1 วินาที) จากตำแหน่งเริ่มต้นเริ่มต้น
• รายการสื่ออื่นๆ ในช่วง n-2 ถึง n+2: Return PreloadStatus.TRACKS_SELECTED
• รายการสื่ออื่นๆ ในช่วง n-4 ถึง n+4: Return PreloadStatus.SOURCE_PREPARED
• สำหรับรายการสื่ออื่นๆ ทั้งหมด ให้แสดงผล null

class MyTargetPreloadStatusControl(var currentPlayingIndex: Int = 0) :
  TargetPreloadStatusControl<Int, DefaultPreloadManager.PreloadStatus> {

  override fun getTargetPreloadStatus(index: Int): DefaultPreloadManager.PreloadStatus {
    if (index - currentPlayingIndex == 1) { // next track
      // return a PreloadStatus that is labelled by STAGE_SPECIFIED_RANGE_LOADED and
      // suggest loading 3000ms from the default start position
      return DefaultPreloadManager.PreloadStatus.specifiedRangeLoaded(3000L)
    } else if (index - currentPlayingIndex == -1) { // previous track
      // return a PreloadStatus that is labelled by STAGE_SPECIFIED_RANGE_LOADED and
      // suggest loading 3000ms from the default start position
      return DefaultPreloadManager.PreloadStatus.specifiedRangeLoaded(3000L)
    } else if (abs(index - currentPlayingIndex) == 2) {
      // return a PreloadStatus that is labelled by STAGE_TRACKS_SELECTED
      return DefaultPreloadManager.PreloadStatus.PRELOAD_STATUS_TRACKS_SELECTED
    } else if (abs(index - currentPlayingIndex) <= 4) {
      // return a PreloadStatus that is labelled by STAGE_SOURCE_PREPARED
      return DefaultPreloadManager.PreloadStatus.PRELOAD_STATUS_SOURCE_PREPARED
    }
    return DefaultPreloadManager.PreloadStatus.PRELOAD_STATUS_NOT_PRELOADED
  }
}
PreloadManagerCreate.kt

ประเด็นสำคัญเกี่ยวกับโค้ด

• คุณจะส่งอินสแตนซ์ของ MyTargetPreloadStatusControl ไปยังเครื่องมือสร้างตัวจัดการการโหลดล่วงหน้าเมื่อสร้าง
• currentPlayingIndex เก็บดัชนีของรายการสื่อที่กำลังเล่นอยู่ แอปมีหน้าที่อัปเดตค่าดังกล่าวให้เป็นปัจจุบันอยู่เสมอ
• เมื่อเครื่องมือจัดการการโหลดล่วงหน้าพร้อมโหลดเนื้อหา ระบบจะเรียกใช้ getTargetPreloadStatus และส่งข้อมูลการจัดอันดับที่คุณระบุ สำหรับรายการสื่อที่เกี่ยวข้อง ในกรณีของ DefaultPreloadManager ข้อมูลการจัดอันดับนั้นจะเป็นจำนวนเต็มที่ระบุตำแหน่งของรายการในภาพสไลด์ เมธอดจะเลือกรหัสที่จะแสดงผลโดยเปรียบเทียบดัชนีนั้นกับดัชนีของรายการที่เลือกอยู่ในปัจจุบัน

สร้างตัวจัดการการโหลดล่วงหน้า

หากต้องการสร้างเครื่องมือจัดการการโหลดล่วงหน้า คุณต้องมี DefaultPreloadManager.Builder เครื่องมือสร้างดังกล่าวได้รับการกำหนดค่าด้วยบริบทปัจจุบันและการควบคุมสถานะการโหลดล่วงหน้าเป้าหมายของแอป คุณสามารถสร้างตัวจัดการการโหลดล่วงหน้าด้วยการกำหนดค่าเริ่มต้นทั้งหมด

val targetPreloadStatusControl = MyTargetPreloadStatusControl()
val preloadManagerBuilder = DefaultPreloadManager.Builder(context, targetPreloadStatusControl)
val preloadManager = preloadManagerBuilder.build()
PreloadManagerCreate.kt

นอกจากนี้ Builder ยังมีเมธอด Setter ที่คุณใช้ตั้งค่าคอมโพเนนต์ที่กำหนดเองของตัวจัดการการโหลดล่วงหน้าได้ด้วย

ตัวอย่างเช่น คุณสามารถปรับแต่งไบต์บัฟเฟอร์ทั้งหมดเป้าหมายสำหรับแหล่งที่มาของสื่อที่โหลดไว้ล่วงหน้าทั้งหมดใน DefaultPreloadManager เพื่อให้ข้อมูลที่โหลดไว้ล่วงหน้าไม่เกินขีดจำกัดนั้น คุณกำหนดค่าขีดจำกัดดังกล่าวได้โดยใช้ setPlayerTargetBufferBytes(String, int) ใน DefaultLoadControl.Builder ที่กำหนดเองซึ่งมีชื่อโปรแกรมเล่น "preload" และ ส่งอินสแตนซ์นั้นไปยังเครื่องมือสร้างตัวจัดการการโหลดล่วงหน้า

val targetPreloadStatusControl = MyTargetPreloadStatusControl()
val preloadManagerBuilder = DefaultPreloadManager.Builder(context, targetPreloadStatusControl)

preloadManagerBuilder.setLoadControl(
  DefaultLoadControl.Builder()
    .setPlayerTargetBufferBytes("preload", 128 * 1024 * 1024) // 128 MiB
    .build()
)
val preloadManager = preloadManagerBuilder.build()
PreloadManagerCreate.kt

แม้ว่าโดยพื้นฐานแล้วเมธอด Setter ของ Builder จะเป็นตัวเลือกสำหรับการปรับแต่ง แต่หากต้องการแคชรายการสื่อลงในดิสก์ คุณต้องกำหนดค่า Builder ด้วย Cache โดยเรียกใช้ setCache() หากไม่ได้กำหนดค่าแคช การพยายามแคชรายการสื่อจะทำให้เกิด IllegalStateException

สร้าง ExoPlayer เพื่อเล่นรายการสื่อที่โหลดไว้ล่วงหน้า

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

// Direct creation
val exoPlayer = preloadManagerBuilder.buildExoPlayer()

// Creation with custom playback specific configurations
val skipSilenceExoPlayerBuilder = ExoPlayer.Builder(context).setSkipSilenceEnabled(true)
val skipSilenceExoPlayer = preloadManagerBuilder.buildExoPlayer(skipSilenceExoPlayerBuilder)
PreloadManagerCreate.kt