ID de l'élément multimédia actuel après la réorganisation (si aucune valeur n'est fournie, la valeur "currentItem" sera la même qu'avant la réorganisation).
currentTime
(nombre ou non défini)
Nombre de secondes écoulées depuis le début du contenu avant le lancement de la lecture de l'élément en cours. Si cette valeur est fournie, elle prévaut sur la valeur startTime fournie au niveau de QueueItem, mais uniquement la première fois que l'élément est lu. Cela permet de couvrir le cas courant où l'utilisateur passe au milieu d'un élément afin que la valeur currentTime ne s'applique pas de manière permanente à l'élément, contrairement à la valeur startTime de QueueItem. Cela évite de devoir réinitialiser le startTime de manière dynamique (ce qui peut être impossible si le téléphone est en veille).
customData
(objet non nul ou non défini)
Données spécifiques à l'application pour cette requête. Elle permet à l'expéditeur et au destinataire d'étendre facilement le protocole multimédia sans avoir à utiliser un nouvel espace de noms avec des messages personnalisés.
Identifiant de l'article qui se trouvera immédiatement après la liste réorganisée.
Si l'ID est introuvable ou qu'il n'est pas fourni, la liste réorganisée est ajoutée à la fin de la liste existante.
itemIds
Tableau de nombres non nuls
ID des articles à réorganiser, dans le nouvel ordre. Les articles non fournis conserveront leur commande existante. La liste fournie sera insérée à la position déterminée par insertBefore.
Exemple :
Si insertBefore n'est pas spécifié
File d'attente existante : "A",D",G",H",H",B",",E"
Si insertBefore est "A"
File d'attente existante : "A",D",G",H",H",B"
Si insertAvant est "G"
File d'attente existante : "A",D",G",H",H",B"
itemIds : "D",H",B"
Nouvelle commande : "A","D",H",B",G",E"
mediaSessionId
(nombre ou non défini)
ID de la session multimédia à laquelle la requête s'applique.
Nombre permettant de synchroniser toutes les commandes de file d'attente.
S'il est fourni pour une commande de file d'attente, le SDK vérifie que le dernier numéro de séquence de la file d'attente correspond à la requête.
Le paramètre "SequenceNumber" actuel est fourni dans les messages sortants de modification de la file d'attente.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003e\u003ccode\u003eQueueReorderRequestData\u003c/code\u003e is used to request reordering of items in a media queue.\u003c/p\u003e\n"],["\u003cp\u003eIt allows specifying the \u003ccode\u003eitemIds\u003c/code\u003e to be reordered and optionally the \u003ccode\u003einsertBefore\u003c/code\u003e position.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecurrentItemId\u003c/code\u003e and \u003ccode\u003ecurrentTime\u003c/code\u003e can be provided to control playback after the reorder.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecustomData\u003c/code\u003e can be included for application-specific needs.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003emediaSessionId\u003c/code\u003e, \u003ccode\u003erequestId\u003c/code\u003e, and \u003ccode\u003esequenceNumber\u003c/code\u003e are inherited properties for request management and synchronization.\u003c/p\u003e\n"]]],[],null,["# Class: QueueReorderRequestData\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).[messages](/cast/docs/reference/web_receiver/cast.framework.messages).QueueReorderRequestData\n================================================================================================================================================================\n\nclass static\n\nMedia event queue REORDER request data.\n\nConstructor\n-----------\n\n### QueueReorderRequestData\n\nnew\nQueueReorderRequestData(itemIds)\n\n| #### Parameter ||\n|---------|--------------------------------------------------------------------------|\n| itemIds | Array of number The IDs of the items to reorder. Value must not be null. |\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 reorder (if not provided, the\ncurrentItem value will be the same as before the reorder).\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### insertBefore\n\n(number or undefined)\n\nID of the item that will be located immediately after the reordered list.\nIf the ID is not found or it is not provided, the reordered list will be\nappended at the end of the existing list.\n\n### itemIds\n\nnon-null Array of number\n\nIDs of the items to be reordered, in the new order. Items not provided\nwill keep their existing order. The provided list will be inserted at the\nposition determined by insertBefore.\nFor example:\n\nIf insertBefore is not specified\nExisting queue: \"A\",\"D\",\"G\",\"H\",\"B\",\"E\"\nitemIds: \"D\",\"H\",\"B\"\nNew Order: \"A\",\"G\",\"E\",\"D\",\"H\",\"B\"\n\nIf insertBefore is \"A\"\nExisting queue: \"A\",\"D\",\"G\",\"H\",\"B\"\nitemIds: \"D\",\"H\",\"B\"\nNew Order: \"D\",\"H\",\"B\",\"A\",\"G\",\"E\"\n\nIf insertBefore is \"G\"\nExisting queue: \"A\",\"D\",\"G\",\"H\",\"B\"\nitemIds: \"D\",\"H\",\"B\"\nNew Order: \"A\",\"D\",\"H\",\"B\",\"G\",\"E\"\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### 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)"]]
