ID dell'elemento multimediale corrente dopo le modifiche (se non fornito o non trovato, il valore currentItem sarà lo stesso di prima dell'aggiornamento).
currentTime
(numero o non definito)
Secondi dall'inizio dei contenuti per avviare la riproduzione dell'elemento corrente. Se fornito, questo valore avrà la precedenza sul valore startTime fornito a livello di QueueItem, ma solo la prima volta che l'elemento viene riprodotto. Questo serve a trattare il caso comune in cui l'utente passa
al centro di un elemento in modo che il valore currentTime non venga applicato
definitivamente all'elemento come fa QueueItem startTime. Consente di evitare di dover reimpostare
il valore startTime in modo dinamico (operazione che potrebbe non essere possibile se lo smartphone
entra in modalità di sospensione).
customData
(oggetto non null o non definito)
Dati specifici dell'applicazione per questa richiesta. Consente al mittente e al destinatario di estendere facilmente il protocollo multimediale senza dover utilizzare un nuovo spazio dei nomi con messaggi personalizzati.
Elenco di elementi della coda da aggiornare. Non verrà eseguito alcun riordinamento; gli articoli manterranno l'ordine esistente.
jump
(numero o non definito)
Salta/torna indietro di numero di elementi rispetto alla posizione di currentItem (può essere negativo). Se è fuori dai limiti, l'elemento currentItem sarà l'elemento logico successivo nella coda a capo attorno ai limiti. La nuova posizione currentItem seguirà le regole del comportamento di ripetizione della coda.
mediaSessionId
(numero o non definito)
ID della sessione multimediale a cui si applica la richiesta.
Un numero per sincronizzare tutti i comandi della coda.
Se fornito per un comando di coda, l'SDK verificherà che il numero di sequenza più recente della coda corrisponda alla richiesta.
L'attuale sequenceNumber viene fornito come parte dei messaggi modificati della coda in uscita.
Gli elementi in coda vengono riprodotti in modo casuale durante l'elaborazione dell'aggiornamento. Dopo l'ordinamento casuale degli elementi della coda, viene caricato l'elemento nella posizione currentItem.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003e\u003ccode\u003eQueueUpdateRequestData\u003c/code\u003e is used to send requests for updating the media queue, such as changing the current item, playback time, or reordering items.\u003c/p\u003e\n"],["\u003cp\u003eIt includes properties for specifying the desired changes, like \u003ccode\u003ecurrentItemId\u003c/code\u003e, \u003ccode\u003ecurrentTime\u003c/code\u003e, \u003ccode\u003eitems\u003c/code\u003e, \u003ccode\u003erepeatMode\u003c/code\u003e, and \u003ccode\u003eshuffle\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecustomData\u003c/code\u003e enables the sender and receiver to exchange application-specific information alongside the queue update request.\u003c/p\u003e\n"],["\u003cp\u003eThe request also includes properties for identification and synchronization, like \u003ccode\u003erequestId\u003c/code\u003e, \u003ccode\u003emediaSessionId\u003c/code\u003e, and \u003ccode\u003esequenceNumber\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use this data structure to build robust media playback experiences with features like queue management, playback control, and custom application logic.\u003c/p\u003e\n"]]],["`QueueUpdateRequestData` manages updates to a media queue. Key actions include defining the `currentItemId`, adjusting `currentTime` for playback start, and using `customData` for extending the protocol. It allows updating `items` while retaining their order and setting the `repeatMode`. Additionally, it manages jumping/skipping with the `jump`, and shuffling the `items` with the option shuffle. It uses `requestId`, `mediaSessionId`, and `sequenceNumber` for synchronization.\n"],null,["# Class: QueueUpdateRequestData\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).[messages](/cast/docs/reference/web_receiver/cast.framework.messages).QueueUpdateRequestData\n===============================================================================================================================================================\n\nclass static\n\nMedia event UPDATE queue request data.\n\nConstructor\n-----------\n\n### QueueUpdateRequestData\n\nnew\nQueueUpdateRequestData()\n\nExtends\n: [cast.framework.messages.RequestData](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData)\n\nProperties\n----------\n\n### currentItemId\n\n(number or undefined)\n\nID of the current media Item after the changes (if not provided or not\nfound, the currentItem value will be the same as before the update).\n\n### currentTime\n\n(number or undefined)\n\nSeconds since the beginning of content to start playback of the current\nitem. If provided, this value will take precedence over the startTime\nvalue provided at the QueueItem level but only the first time the item is\nplayed. This is to cover the common case where the user jumps to the\nmiddle of an item so the currentTime does not apply to the item\npermanently like the QueueItem startTime does. It avoids having to reset\nthe startTime dynamically (that may not be possible if the phone has gone\nto sleep).\n\n### customData\n\n(non-null Object or undefined)\n\nApplication-specific data for this request. It enables the sender and\nreceiver to easily extend the media protocol without having to use a new\nnamespace with custom messages.\n\nInherited from\n: [cast.framework.messages.RequestData#customData](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#customData)\n\n### items\n\n(non-null Array of non-null [cast.framework.messages.QueueItem](/cast/docs/reference/web_receiver/cast.framework.messages.QueueItem) or undefined)\n\nList of queue items to be updated. No reordering will happen, the items\nwill retain the existing order.\n\n### jump\n\n(number or undefined)\n\nSkip/Go back number of items with respect to the position of currentItem (it can be negative). If it is out of boundaries, the currentItem will be the next logical item in the queue wrapping around the boundaries. The new currentItem position will follow the rules of the queue repeat behavior.\n\n### mediaSessionId\n\n(number or undefined)\n\nId of the media session that the request applies to.\n\nInherited from\n: [cast.framework.messages.RequestData#mediaSessionId](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#mediaSessionId)\n\n### repeatMode\n\n(non-null [cast.framework.messages.RepeatMode](/cast/docs/reference/web_receiver/cast.framework.messages#.RepeatMode) or undefined)\n\nBehavior of the queue when all items have been played.\n\n### requestId\n\nnumber\n\nId of the request, used to correlate request/response.\n\nInherited from\n: [cast.framework.messages.RequestData#requestId](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#requestId)\n\n### sequenceNumber\n\n(number or undefined)\n\nA number to synchronize all queue commands.\nIf provided for a queue command, the SDK will verify the queue latest\nsequence number match the request.\nCurrent sequenceNumber is provided as part of outgoing queue changed\nmessages.\n\nInherited from\n: [cast.framework.messages.RequestData#sequenceNumber](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#sequenceNumber)\n\n### shuffle\n\n(boolean or undefined)\n\nShuffle the queue items when the update is processed. After the queue\nitems are shuffled, the item at the currentItem position will be loaded."]]
