cast.
媒體事件佇列 LOAD 要求資料。
建構函式
QueueLoadRequestData
new QueueLoadRequestData(items)
參數 |
|
|---|---|
|
items |
非空值 cast.framework.messages.QueueItem 陣列 佇列項目清單。項目的 itemId 欄位必須為空白，否則要求會失敗，並顯示 INVALID_PARAMS 錯誤。並已排序 (會先播放第一個元素)。 值不得為空值。 |
屬性
currentTime
(數字或未定義)
從內容開頭開始播放第一個要播放的秒數。如有提供，此值的優先順序會高於在 QueueItem 層級提供的 startTime 值，但僅限於項目首次播放時。這涵蓋了使用者投放本機播放的項目常見情況，因此目前時間不會像 QueueItem startTime 一樣套用至項目。這樣可以避免必須動態重設 startTime (如果手機進入睡眠狀態，可能無法執行這項操作)。
customData
(非空值或未定義的物件)
這項要求的應用程式專屬資料。透過這項功能，傳送者和接收方可以輕鬆擴充媒體通訊協定，不必使用自訂訊息使用新的命名空間。
items
非空值的 cast.framework.messages.QueueItem 非空值陣列
佇列項目陣列。並已排序 (第一個元素會優先播放)。
mediaSessionId
(數字或未定義)
要求套用的媒體工作階段 ID。
repeatMode
(cast.framework.messages.RepeatMode 或未定義)
播放所有項目時加入佇列的行為。
requestId
號碼
要求的 ID，用於建立要求/回應的關聯。
sequenceNumber
(數字或未定義)
同步處理所有佇列指令的數字。 如果為佇列指令提供，SDK 會驗證佇列的最新序號與要求相符。目前的 orderNumber 會在傳出佇列已變更訊息中提供。
startIndex
(數字或未定義)
商品陣列中的項目索引，必須是第一個目前項目 (會先播放的項目)。請注意，這是陣列的索引 (從 0 開始)，而不是 itemId (因為必須先建立佇列才知道這個索引)。如果 repeatMode 為 REPEAT_OFF 播放作業會在陣列中的最後一個項目播放時結束 (不會播放 startIndex 之前的元素)。在使用者已使用傳送端應用程式，而中間決定投放的連續情境時，這項功能就能派上用場。這樣一來，傳送者應用程式就不需要在本機和遠端佇列位置之間對應，也不必儲存一個額外的 QUEUE_UPDATE 要求。