佇列更新要求資料

新的 QueueUpdateRequestData()

擴充

cast.framework.messages.RequestData

目前項目編號

(數字或不定義)

變更後的目前媒體項目 ID (如果未提供或找不到，目前的 Item 值將與更新前相同)。

currentTime

(數字或不定義)

自內容開始播放後開始的目前秒數。如果提供這個值，系統會優先於 QueueItem 層級提供的 startTime 值，但只有在第一次播放該項目時，才會優先採用這個值。這指的是使用者通常在進入商品中間時會遇到的常見情況，因此目前的 Time 不會像 QueueItem startTime 一樣適用於該項目。可避免必須動態重設 startTime (手機進入休眠時可能無法重設)。

自訂資料

(非空值物件或未定義)

此要求的應用程式特定資料。透過這項功能，寄件者和接收器可以輕鬆擴充媒體通訊協定，而無需將新的命名空間與自訂訊息搭配使用。

繼承來源

cast.framework.messages.RequestData#customData

items

(非空值的 cast.framework.messages.QueueItem 或未定義的陣列)

要更新的佇列項目清單。系統不會重新訂購項目，這些項目將保留現有順序。

跳躍

(數字或不定義)

略過/返回 相對於 currentItem 位置的項目數 (可以是負數)。如果超過範圍限制，目前的項目將成為佇列中下一個環繞界線的邏輯項目。新的 currentItem 位置將遵循佇列重複行為的規則。

媒體工作階段編號

(數字或不定義)

要求套用的媒體工作階段 ID。

繼承來源

cast.framework.messages.RequestData#mediaSessionId

repeat 模式

(非空值的 cast.framework.messages.RepeatMode 或未定義)

佇列中所有項目都播放完畢時的行為。

requestId (要求 ID)

數字

要求的 ID，用來為要求/回應建立關聯。

繼承來源

cast.framework.messages.RequestData#requestId

序號

(數字或不定義)

用於同步處理所有佇列指令的編號。 如果為佇列指令提供資料，SDK 會驗證佇列的最新序號是否與要求相符。目前的序列號碼會在傳出佇列的變更訊息中提供。

繼承來源

cast.framework.messages.RequestData#serialNumber

重組

(布林值或未定義)

處理更新作業時，請隨機調整佇列項目。隨機播放佇列項目之後，系統將會載入目前商品位置中的項目。