cast. framework. messages. QueueItem
佇列項目資訊。應用程式開發人員可能需要建立 QueueItem,才能使用 cast.framework.messages.InsertQueueItems 插入佇列元素。在這種情況下,他們不應提供 itemId (因為項目在佇列中插入時,將會指派實際的 itemId)。這可防止 ID 與來自寄件者應用程式新增的項目發生衝突。
建構函式
佇列項目
新 QueueItem(opt_itemId)
參數 |
|
---|---|
最佳化項目 ID |
選用 數字 商品 ID。 |
屬性
有效的追蹤 ID
(非空值陣列或未定義的陣列)
使用中的 track trackId 陣列。如未提供陣列,系統將啟用預設音軌。
自動播放
(布林值或未定義)
如果未指定自動播放參數或為 true,媒體項目會在項目成為 CurrentItem 時,開始排入佇列中的元素。
自訂資料
(可為空值物件或未定義)
應用程式可以定義任何額外的佇列項目資訊。
項目編號
(數字或不定義)
佇列中項目的專屬 ID。由於 LOAD 或 INSERT 不可提供,因此這項屬性並非必要 (因為接收器會在首次建立/插入項目時指派)。
media
(非空值的 cast.framework.messages.MediaInformation 或未定義)
播放清單元素的中繼資料 (包括 contentId)。
orderId
(數字或不定義)
用於追蹤佇列中特定項目的原始順序,以復原隨機播放。
preloadTime
(數字或不定義)
此參數表示接收器會在播放此媒體前,預先載入這個媒體項目。如此一來,便可從佇列播放的項目順暢轉換。此時間以秒計算 (相對於前一項項目播放的結束) 開始的時間,以秒為單位。例如,如果值為 10 秒,此項目會在前一項項目完成前 10 秒預先載入。接收器會嘗試遵循這個值,但無法保證值,例如,如果值大於前一個項目持續時間,接收器會在前次項目開始後不久隨即預先載入這個項目 (永遠不會同時預先載入兩個項目)。此外,如果該項目在 currentItem 之後插入佇列中,並且預先載入的時間大於目前項目的剩餘時間,就會盡快發生預先載入。負值會明確停用預先載入功能。如果值為 0 或未定義,則媒體項目會在其播放位置結束後完整下載,並立即開始預先載入。
開始時間
(數字或不定義)
內容開始後經過的秒數。如果內容是即時內容,且未指定 startTime,串流就會開始播放。