cast.
Dane żądania LOAD z kolejki zdarzeń multimediów.
Zespół
QueueLoadRequestData
new QueueLoadRequestData(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
currentTime
(liczba lub wartość nieokreślona)
Sekundy (od początku treści), aby rozpocząć odtwarzanie pierwszego elementu. Jeśli zostanie podana, ma ona pierwszeństwo przed wartością startTime podaną na poziomie QueueItem, ale tylko przy pierwszym odtworzeniu elementu. Obejmuje to typowy przypadek, w którym użytkownik przesyła element, który był odtwarzany lokalnie. Dzięki temu parametr currentTime nie jest stosowany do tego elementu na stałe, tak 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
items
tablica niezerowa z wartością nienull cast.framework.messages.QueueItem
Tablica elementów kolejki. 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
repeatMode
(cast.framework.messages.RepeatMode lub nie określono)
Działanie kolejki po odtworzeniu wszystkich elementów.
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
startIndex
(liczba lub wartość nieokreślona)
Indeks elementu w tablicy items, który musi być pierwszym elementem currentItem (element, który zostanie odtworzony jako pierwszy). Zwróć uwagę, że jest to indeks tablicy (zaczyna się od 0), a nie identyfikator elementu (który nie jest znany, dopóki nie zostanie utworzona kolejka). Jeśli tryb powtarzania ma wartość REPEAT_OFF, odtwarzanie kończy się po odtworzeniu ostatniego elementu w tablicy (elementy poprzedzające indeks startIndex nie są odtwarzane). Może to być przydatne w sytuacjach, gdy użytkownik korzysta już z aplikacji nadawcy, ale w tym momencie decyduje się na przesyłanie. Dzięki temu aplikacja nadawcy nie musi mapować położenia kolejki lokalnej i zdalnej ani zapisywać jednego dodatkowego żądania QUEUE_UPDATE.