cast. framework. ข้อความ QueueItem
ข้อมูลรายการในคิว นักพัฒนาแอปพลิเคชันอาจต้องสร้าง QueueItem เพื่อแทรกองค์ประกอบคิวโดยใช้ Cast.framework.messages.InsertQueues ในกรณีนี้ รหัสดังกล่าวไม่ควรระบุ itemId (เนื่องจากระบบจะกำหนด itemId จริงเมื่อมีการแทรกรายการในคิว) ซึ่งจะช่วยป้องกันไม่ให้รหัสทับซ้อนกับรายการที่เพิ่มจากแอปผู้ส่ง
ผู้ผลิต
QueueItem
ใหม่ QueueItem(opt_itemId)
พารามิเตอร์ |
|
---|---|
opt_itemId |
ไม่บังคับ ตัวเลข รหัสสินค้า |
พร็อพเพอร์ตี้
activeTrackIds
(อาร์เรย์ของตัวเลขที่ไม่เป็นค่าว่าง หรือไม่ได้ระบุ)
อาร์เรย์ของ trackIds ที่ใช้งานอยู่ หากไม่ได้ระบุอาร์เรย์ แทร็กเริ่มต้นจะทำงาน
เล่นอัตโนมัติ
(บูลีนหรือไม่ระบุ)
หากไม่ได้ระบุพารามิเตอร์การเล่นอัตโนมัติหรือค่าเป็นจริง โปรแกรมเล่นสื่อจะเริ่มเล่นองค์ประกอบในคิวเมื่อรายการกลายเป็น currentItem
customData
(อ็อบเจ็กต์ Nullable หรือไม่ได้กำหนด)
แอปพลิเคชันจะกำหนดข้อมูลรายการคิวเพิ่มเติมที่จำเป็นได้
itemId
(ตัวเลขหรือไม่ระบุ)
ตัวระบุที่ไม่ซ้ำกันของรายการในคิว แอตทริบิวต์นี้ไม่บังคับ เนื่องจากไม่ควรระบุ LOAD หรือ INSERT (เนื่องจากผู้รับจะกำหนดแอตทริบิวต์นี้เมื่อสร้าง/แทรกรายการเป็นครั้งแรก)
สื่อ
(cast.framework.messages.MediaInformation ที่ไม่ใช่ null หรือไม่ได้ระบุ)
ข้อมูลเมตา (รวมถึง contentId) ขององค์ประกอบเพลย์ลิสต์
orderId
(ตัวเลขหรือไม่ระบุ)
ใช้เพื่อติดตามลำดับเดิมของรายการในคิวเพื่อเลิกทำการสุ่ม
preloadTime
(ตัวเลขหรือไม่ระบุ)
พารามิเตอร์นี้เป็นคำแนะนำสำหรับผู้รับให้โหลดรายการสื่อนี้ล่วงหน้าก่อนที่ระบบจะเล่น ซึ่งจะช่วยให้การเปลี่ยนรายการที่เล่นจากคิวเป็นไปอย่างราบรื่น เวลาจะแสดงเป็นหน่วยวินาทีซึ่งสัมพันธ์กับจุดเริ่มต้นของการเล่นรายการนี้ (โดยปกติจะเป็นการสิ้นสุดการเล่นรายการก่อนหน้า) เช่น หากค่าคือ 10 วินาที ระบบจะโหลดรายการนี้ล่วงหน้า 10 วินาทีก่อนที่รายการก่อนหน้าจะเสร็จสิ้น ผู้รับจะพยายามใช้ค่านี้แต่จะไม่รับประกัน เช่น หากค่าดังกล่าวมากกว่าระยะเวลาของรายการก่อนหน้า ผู้รับอาจโหลดรายการนี้ล่วงหน้าไม่นานหลังจากที่รายการก่อนหน้าเริ่มเล่น (จะไม่มีการโหลด 2 รายการไว้ล่วงหน้าพร้อมกัน) นอกจากนี้ หากมีการแทรกรายการในคิวหลังจาก currentItem และเวลาที่ใช้ในการโหลดล่วงหน้าสูงกว่าเวลาที่เหลือบน currentItem การโหลดล่วงหน้าจะเกิดขึ้นโดยเร็วที่สุด ค่าเชิงลบจะปิดใช้การโหลดล่วงหน้าอย่างชัดแจ้ง หากมีค่าเป็น 0 หรือไม่ได้ระบุ รายการสื่อจะเริ่มโหลดล่วงหน้าทันทีที่ดาวน์โหลดรายการก่อนหน้าเสร็จสมบูรณ์หลังจากตำแหน่งการเล่น
startTime
(ตัวเลขหรือไม่ระบุ)
จำนวนวินาทีนับตั้งแต่เริ่มต้นเนื้อหา หากเนื้อหาเป็นเนื้อหาสดและไม่ได้ระบุเวลาเริ่มต้น สตรีมจะเริ่มต้นจากตำแหน่งถ่ายทอดสด