cast.
媒體事件佇列 INSERT 要求資料。
建構函式
QueueInsertRequestData
new QueueInsertRequestData(items)
參數 |
|
|---|---|
|
items |
非空值 cast.framework.messages.QueueItem 陣列 佇列項目清單。項目的 itemId 欄位必須為空白，否則要求會失敗，並顯示 INVALID_PARAMS 錯誤。並已排序 (會先播放第一個元素)。 值不得為空值。 |
屬性
currentItemId
(數字或未定義)
目前媒體項目的 ID (如未提供，目前項目的值會與插入前相同)。
currentItemIndex
(數字或未定義)
新媒體項目的索引 (相對於項目陣列，從 0 開始)。針對插入的項目，我們會使用索引 (類似於 QUEUE_LOAD 中的 startIndex) 而非 currentItemId，因為插入項目之前，項目 Id 仍為未知。如未提供，目前項目的值會與插入前相同 (除非提供 currentItemId)。 此參數可讓您以不可分割的形式，讓插入與播放項目的常見用途更完整。
currentTime
(數字或未定義)
從內容開頭開始播放目前項目的秒數。如有提供，此值的優先順序會高於在 QueueItem 層級提供的 startTime 值，但僅限於項目首次播放時。這是考量使用者跳至項目中間的常見情況，因此目前時間不會像 QueueItem startTime 永久套用至項目。這樣可以避免必須動態重設 startTime (如果手機進入睡眠狀態，可能無法執行這項操作)。
customData
(非空值或未定義的物件)
這項要求的應用程式專屬資料。透過這項功能，傳送者和接收方可以輕鬆擴充媒體通訊協定，不必使用自訂訊息使用新的命名空間。
insertBefore
(數字或未定義)
位於插入清單後方的項目 ID。 如果找不到 ID 或是未提供 ID，系統會在現有清單的結尾附加清單。
items
非空值的 cast.framework.messages.QueueItem 非空值陣列
佇列項目清單。商品的 itemId 欄位應留空。並已排序 (會先播放第一個元素)。
mediaSessionId
(數字或未定義)
要求套用的媒體工作階段 ID。
requestId
號碼
要求的 ID，用於建立要求/回應的關聯。
sequenceNumber
(數字或未定義)
同步處理所有佇列指令的數字。 如果為佇列指令提供，SDK 會驗證佇列的最新序號與要求相符。目前的 orderNumber 會在傳出佇列已變更訊息中提供。