cast.
INSERT – dane żądania z kolejki zdarzeń multimedialnych.
Zespół
QueueInsertRequestData
new QueueInsertRequestData(items)
Parametr |
|
|---|---|
|
items |
Tablica nienull cast.framework.messages.QueueItem Lista elementów kolejki. Pole itemId powinno być puste. W przeciwnym razie żądanie nie zakończy się niepowodzeniem i wystąpi błąd FAILED_PARAMS. Jest posortowana (pierwszy element zostanie odtworzony jako pierwszy). Wartość nie może być wartością null. |
- Rozszerzone
- cast.framework.messages.RequestData
Właściwości
currentItemId
(liczba lub wartość nieokreślona)
Identyfikator bieżącego elementu multimedialnego po wstawieniu (jeśli nie zostanie podany, wartość currentItem będzie taka sama jak przed wstawieniem).
currentItemIndex
(liczba lub wartość nieokreślona)
Indeks (w odniesieniu do tablicy items, zaczynający się od 0) nowego bieżącego elementu multimediów. W przypadku wstawionych elementów używamy indeksu (podobnego do startIndex w ciągu QUEUE_LOAD), a nie z pola currentItemId, ponieważ identyfikator itemId jest nieznany, dopóki elementy nie zostaną wstawione. Jeśli nie zostanie podana, wartość currentItem będzie taka sama jak przed wstawieniem (chyba że podano atrybut currentItemId). Ten parametr umożliwia ustawienie elementu atomowego jako typowego przypadku użycia wstawiania i odtwarzania elementu.
currentTime
(liczba lub wartość nieokreślona)
Liczba sekund od początku treści do rozpoczęcia odtwarzania bieżącego elementu. Jeśli zostanie podana, ma pierwszeństwo przed wartością startTime podaną na poziomie QueueItem, ale tylko przy pierwszym odtworzeniu elementu. Dotyczy to typowego przypadku, w którym użytkownik przeskakuje do środka elementu, dzięki czemu właściwość currentTime nie jest trwale stosowana do elementu, jak ma to miejsce w przypadku elementu QueueItem startTime. Pozwala to uniknąć konieczności dynamicznego resetowania wartości startTime (co może nie być możliwe, jeśli telefon przeszedł w tryb uśpienia).
customData
(niepusty obiekt lub niezdefiniowany)
Dane aplikacji dla tego żądania. Umożliwia nadawcy i odbiorcy łatwe rozszerzenie protokołu multimediów bez konieczności używania nowej przestrzeni nazw na potrzeby wiadomości niestandardowych.
- Odziedziczone z:
- cast.framework.messages.RequestData#customData
insertBefore
(liczba lub wartość nieokreślona)
Identyfikator produktu, który będzie znajdować się bezpośrednio po wstawionej liście. Jeśli identyfikator nie zostanie znaleziony lub nie zostanie podany, lista zostanie dodana na końcu istniejącej listy.
items
tablica niezerowa z wartością nienull cast.framework.messages.QueueItem
Lista elementów kolejki. Pole itemId powinno być puste. Jest posortowana (pierwszy element zostanie odtworzony jako pierwszy).
mediaSessionId
(liczba lub wartość nieokreślona)
Identyfikator sesji multimediów, której dotyczy żądanie.
- Odziedziczone z:
- cast.framework.messages.RequestData#mediaSessionId
requestId
Liczba
Identyfikator żądania używany do skorelowania żądania i odpowiedzi.
- Odziedziczone z:
- cast.framework.messages.RequestData#requestId
sequenceNumber
(liczba lub wartość nieokreślona)
Liczba synchronizowana wszystkich poleceń kolejki. Jeśli zostanie przekazane w poleceniu kolejki, pakiet SDK sprawdzi, czy najnowszy numer kolejki jest zgodny z żądaniem. Bieżąca wartość sekwencyjna jest podawana jako część komunikatów zmienionych w kolejce wychodzącej.
- Odziedziczone z:
- cast.framework.messages.RequestData#sequenceNumber