cast.
Dodaj informacje o elemencie do kolejki. Być może deweloperzy aplikacji będą musieli utworzyć element QueueItem, aby wstawić element kolejki za pomocą cast.framework.messages.InsertQueueItems. W tym przypadku nie powinny podawać identyfikatora itemId (ponieważ rzeczywisty identyfikator elementu zostanie przypisany po wstawieniu elementu do kolejki). Zapobiega to konfliktom identyfikatorów z elementami dodanymi z aplikacji nadawcy.
Zespół
QueueItem
new QueueItem(opt_itemId)
Parametr |
|
|---|---|
|
opt_itemId |
Opcjonalnie Liczba Identyfikator produktu. |
Właściwości
activeTrackIds
(niepusta tablica liczb lub niezdefiniowana)
Tablica aktywnych identyfikatorów śledzenia. Jeśli tablica nie jest podana, aktywne będą ścieżki domyślne.
autoodtwarzanie
(wartość logiczna lub nieokreślona)
Jeśli parametr autoodtwarzania nie jest określony lub ma wartość prawda, odtwarzacz rozpocznie odtwarzanie elementu z kolejki, gdy stanie się on elementem currentItem.
customData
(obiekt z możliwością wartości null lub niezdefiniowany)
Aplikacja może zdefiniować wszelkie dodatkowe informacje o elemencie kolejki, które są potrzebne.
itemId
(liczba lub wartość nieokreślona)
Unikalny identyfikator elementu w kolejce. Ten atrybut jest opcjonalny, ponieważ nie należy podawać wartości w polu LOAD ani INSERT (ponieważ zostanie on przypisany przez odbiorcę po utworzeniu/wstawieniu elementu).
media
(wartość nienull cast.framework.messages.MediaInformation lub niezdefiniowana)
Metadane (w tym contentId) elementu playlisty.
orderId
(liczba lub wartość nieokreślona)
Służy do śledzenia pierwotnej kolejności elementów w kolejce i cofania tasowania.
preloadTime
(liczba lub wartość nieokreślona)
Ten parametr jest wskazówką dla odbiorcy, aby wstępnie załadował element multimedialny, zanim zostanie odtworzony. Umożliwia ona płynne przejście między elementami odtwarzanymi z kolejki. Czas jest wyrażony w sekundach i porównywany z początkiem odtwarzania danego elementu (zwykle jest to koniec odtwarzania poprzedniego elementu). Jeśli np. wartość to 10 sekund, ten element zostanie wstępnie wczytany 10 sekund przed zakończeniem czasu poprzedniego. Odbiorca spróbuje uwzględnić tę wartość, ale nie będzie jej gwarantował. Jeśli na przykład jest ona większa niż poprzedni czas trwania elementu, odbiorca może go wstępnie wczytać tuż po rozpoczęciu odtwarzania poprzedniego elementu (nie będą wówczas ładowane 2 elementy równolegle). Poza tym jeśli element jest wstawiony w kolejce tuż za obiektem currentItem, a czas do wstępnego załadowania jest dłuższy niż czas pozostały do elementu currentItem, wczytywanie wstępne odbędzie się po prostu jak najszybciej. Wartości ujemne wyraźnie wyłączają wstępne wczytywanie. Jeśli wartość to 0 lub nieokreślona, wstępne wczytywanie elementu multimedialnego rozpocznie się, gdy tylko poprzedni element zostanie w pełni pobrany po pozycji odtwarzania.
startTime
(liczba lub wartość nieokreślona)
Liczba sekund od rozpoczęcia treści. Jeśli są to treści na żywo, a czas rozpoczęcia nie jest określony, transmisja rozpocznie się od miejsca na żywo.