คลาส: QueueItem

cast.framework.ข้อความQueueItem

class   static

ข้อมูลรายการในคิว นักพัฒนาแอปพลิเคชันอาจต้องสร้าง 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

(ตัวเลขหรือไม่ระบุ)

จำนวนวินาทีนับตั้งแต่เริ่มต้นเนื้อหา หากเนื้อหาเป็นเนื้อหาสดและไม่ได้ระบุเวลาเริ่มต้น สตรีมจะเริ่มต้นจากตำแหน่งถ่ายทอดสด