cast. framework. messages. QueueInsertRequestData
INSERT-Anfragedaten der Warteschlange für Medienereignisse.
Konstruktor
QueueInsertRequestData
new QueueInsertRequestData(items)
Parameter |
|
---|---|
items |
Array von cast.framework.messages.QueueItem, der nicht null ist Liste der Warteschlangenelemente. Das „itemId“-Feld der Elemente sollte leer sein. Andernfalls schlägt die Anfrage mit dem Fehler INVALID_PARAMS fehl. Sie wird sortiert (das erste Element wird zuerst abgespielt). Der Wert darf nicht null sein. |
- Erweitert
- cast.framework.messages.RequestData
Attribute
currentItemId (Aktuelle Artikel-ID)
(Zahl oder nicht definiert)
ID des aktuellen Media-Elements nach dem Einfügen (falls nicht angegeben, ist der currentItem-Wert mit dem Wert vor dem Einfügen identisch).
currentItemIndex
(Zahl oder nicht definiert)
Index (relativ zum Element-Array, beginnend mit 0) des neuen aktuellen Medienelements. Für eingefügte Elemente wird der Index verwendet (ähnlich wie startIndex in QUEUE_LOAD), nicht „currentItemId“, da „itemId“ erst nach dem Einfügen der Elemente unbekannt ist. Wenn nicht angegeben, ist der currentItem-Wert der gleiche wie vor dem Einfügen (sofern currentItemId angegeben ist). Mit diesem Parameter können Sie ein Element in kleinstmöglichen Fällen zum Einfügen und Abspielen eines Elements verwenden.
currentTime (Aktuelle Uhrzeit)
(Zahl oder nicht definiert)
Sekunden seit Beginn des Inhalts, ab dem das aktuelle Element wiedergegeben werden soll. Wenn dieser Wert angegeben wird, hat er Vorrang vor dem auf QueueItem-Ebene angegebenen startTime-Wert, aber nur bei der ersten Wiedergabe des Elements. Damit wird der häufige Fall abgedeckt, in dem der Nutzer in die Mitte eines Elements springt, sodass die currentTime nicht wie das QueueItem-Startzeit dauerhaft auf das Element angewendet wird. Dadurch wird vermieden, dass die Startzeit dynamisch zurückgesetzt wird. Dies ist möglicherweise nicht möglich, wenn das Smartphone in den Ruhemodus wechselt.
CustomData
(nicht null oder nicht definiert)
Anwendungsspezifische Daten für diese Anfrage. Dadurch können Absender und Empfänger das Medienprotokoll ganz einfach erweitern, ohne einen neuen Namespace mit benutzerdefinierten Nachrichten verwenden zu müssen.
- Übernommen von
- cast.framework.messages.RequestData#customData
Vorher einfügen
(Zahl oder nicht definiert)
ID des Elements, das sich direkt nach der eingefügten Liste befindet. Wenn die ID nicht gefunden oder nicht angegeben wird, wird die Liste am Ende der vorhandenen Liste angehängt.
items
Nicht-null-Array von cast.framework.messages.QueueItem
Liste der Warteschlangenelemente. Das Feld „itemId“ der Elemente muss leer sein. Sie ist sortiert (das erste Element wird zuerst abgespielt).
mediaSessionId (Mediensitzungs-ID)
(Zahl oder nicht definiert)
ID der Mediensitzung, für die die Anfrage gilt.
- Übernommen von
- cast.framework.messages.RequestData#mediaSessionId
requestId
Zahl
ID der Anfrage, die zum Korrelieren von Anfrage/Antwort verwendet wird.
- Übernommen von
- cast.framework.messages.RequestData#requestId
Sequenznummer
(Zahl oder nicht definiert)
Eine Zahl zum Synchronisieren aller Warteschlangenbefehle. Wenn für einen Warteschlangenbefehl eine Option angegeben wird, prüft das SDK die letzte Sequenznummer der Warteschlange. Die aktuellesequenzNumber wird als Teil der geänderten Nachrichten der Warteschlange angegeben.
- Übernommen von
- cast.framework.messages.RequestData#sequenceNumber