คลาส: QueueInsertRequestData

ผู้ผลิต

QueueInsertRequestData

ใหม่ QueueInsertRequestData(items)

พารามิเตอร์

items

อาร์เรย์ของ cast.framework.messages.QueueItem ที่ไม่ใช่ null

รายการคิว ช่อง itemId ของรายการควรเว้นว่างไว้ ไม่เช่นนั้นคำขอจะดำเนินการไม่สำเร็จโดยมีข้อผิดพลาด INVALID_PARAMS จะมีการจัดเรียง (องค์ประกอบแรกจะเล่นก่อน)

ค่าต้องไม่เป็นค่าว่าง

ขยาย
cast.framework.messages.RequestData

พร็อพเพอร์ตี้

currentItemId

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

รหัสของรายการสื่อปัจจุบันหลังการแทรก (หากไม่ได้ระบุไว้ ค่า currentItem จะเป็นค่าเดียวกับที่อยู่ก่อนการแทรก)

currentItemIndex

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

ดัชนี (สัมพันธ์กับอาร์เรย์ items เริ่มต้นด้วย 0) ของรายการสื่อปัจจุบันใหม่ สำหรับรายการที่แทรก เราจะใช้ดัชนี (คล้ายกับ startIndex ใน QUEUE_LOAD) และไม่ใช่ currentItemId เนื่องจากเราไม่รู้จัก itemId จนกว่าจะมีการแทรกรายการ หากไม่ได้ระบุไว้ ค่า currentItem จะเป็นค่าเดียวกับก่อนการแทรก (เว้นแต่จะระบุ currentItemId) พารามิเตอร์นี้ทำให้อะตอมเป็น Use Case ที่พบบ่อยของการแทรกและเล่นรายการ

currentTime

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

จำนวนวินาทีนับจากจุดเริ่มต้นของเนื้อหาที่จะเริ่มเล่นรายการปัจจุบัน หากระบุ ค่านี้จะมีความสำคัญเหนือกว่าค่า startTime ที่ระบุที่ระดับ QueueItem แต่เฉพาะครั้งแรกที่มีการเล่นรายการเท่านั้น เพื่อไม่ให้เกิดกรณีทั่วไปที่ผู้ใช้ข้ามไปที่จุดกึ่งกลางของรายการ ระบบจึงไม่ได้ใช้ currentTime กับรายการนั้นอย่างถาวรเหมือนกับเวลาเริ่มต้นของ QueueItem คุณไม่ต้องรีเซ็ตเวลาเริ่มต้นแบบไดนามิก (ซึ่งอาจทำไม่ได้หากโทรศัพท์เข้าสู่โหมดสลีป)

customData

(ออบเจ็กต์ที่ไม่เป็นค่าว่างหรือไม่ได้ระบุ)

ข้อมูลเฉพาะแอปพลิเคชันสำหรับคำขอนี้ ซึ่งช่วยให้ผู้ส่งและผู้รับขยายโปรโตคอลสื่อได้อย่างง่ายดายโดยไม่ต้องใช้เนมสเปซใหม่ที่มีข้อความที่กำหนดเอง

รับค่ามาจาก
cast.framework.messages.RequestData#customData

insertBefore

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

รหัสของรายการที่จะอยู่ต่อจากรายการที่แทรกทันที หากไม่พบรหัสหรือไม่ได้ให้รหัสไว้ รายการจะต่อท้ายรายการที่มีอยู่

items

อาร์เรย์ที่ไม่เป็นค่าว่างของ cast.framework.messages.QueueItem

รายการคิว ช่อง itemId ของรายการควรว่างเปล่า โดยมีการจัดเรียง (องค์ประกอบแรกจะเล่นก่อน)

mediaSessionId

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

รหัสเซสชันสื่อที่ใช้กับคำขอ

รับค่ามาจาก
cast.framework.messages.RequestData#mediaSessionId

requestId

ตัวเลข

รหัสของคำขอ ซึ่งใช้เพื่อเชื่อมโยงคำขอ/การตอบกลับ

รับค่ามาจาก
cast.framework.messages.RequestData#requestId

sequenceNumber

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

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

รับค่ามาจาก
cast.framework.messages.RequestData#sequenceNumber