Liste des éléments de la file d'attente.
Le champ "itemId" des articles doit être vide, sans quoi la requête échouera et générera une erreur INVALID_PARAMS. Il est trié (le premier élément est lu en premier).
ID de l'élément multimédia actuel après l'insertion (si aucune valeur n'est fournie, la valeur "currentItem" sera la même qu'avant l'insertion).
currentItemIndex
(nombre ou non défini)
Index (par rapport au tableau d'éléments, en commençant par 0) du nouvel élément multimédia actuel. Pour les éléments insérés, nous utilisons l'index (semblable à startIndex dans QUEUE_LOAD) et non l'élément currentItemId, car l'itemId est inconnu jusqu'à ce que les éléments soient insérés. Si elle n'est pas fournie, la valeur "currentItem" sera la même qu'avant l'insertion (sauf si la valeur "currentItemId" est spécifiée).
Ce paramètre permet d'utiliser Atom comme cas d'utilisation courant : insérer et lire un élément.
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 insérée.
Si l'ID est introuvable ou qu'il n'est pas fourni, la liste est ajoutée à la fin de la liste existante.
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\u003eQueueInsertRequestData\u003c/code\u003e is used to request insertion of media items into the queue.\u003c/p\u003e\n"],["\u003cp\u003eIt provides parameters to specify the items to be inserted, their position in the queue, and playback behavior.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eitems\u003c/code\u003e field is mandatory and contains an array of \u003ccode\u003eQueueItem\u003c/code\u003e objects representing the media to be inserted.\u003c/p\u003e\n"],["\u003cp\u003eProperties such as \u003ccode\u003ecurrentItemId\u003c/code\u003e, \u003ccode\u003ecurrentItemIndex\u003c/code\u003e, and \u003ccode\u003ecurrentTime\u003c/code\u003e allow for controlling playback after insertion.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003einsertBefore\u003c/code\u003e enables specifying the insertion point within the existing queue.\u003c/p\u003e\n"]]],[],null,["# Class: QueueInsertRequestData\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).[messages](/cast/docs/reference/web_receiver/cast.framework.messages).QueueInsertRequestData\n===============================================================================================================================================================\n\nclass static\n\nMedia event queue INSERT request data.\n\nConstructor\n-----------\n\n### QueueInsertRequestData\n\nnew\nQueueInsertRequestData(items)\n\n| #### Parameter ||\n|-------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| items | Array of non-null [cast.framework.messages.QueueItem](/cast/docs/reference/web_receiver/cast.framework.messages.QueueItem) List of queue items. The itemId field of the items should be empty or the request will fail with an INVALID_PARAMS error. It is sorted (first element will be played first). 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 insertion (if not provided, the\ncurrentItem value will be the same as before the insertion).\n\n### currentItemIndex\n\n(number or undefined)\n\nIndex (relative to the items array, starting with 0) of the new current\nmedia Item. For inserted items we use the index (similar to startIndex in\nQUEUE_LOAD) and not currentItemId, because the itemId is unknown until\nthe items are inserted. If not provided, the currentItem value will be\nthe same as before the insertion (unless currentItemId is provided).\nThis param allows to make atomic the common use case of insert and play\nan item.\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 inserted list.\nIf the ID is not found or it is not provided, the list will be appended\nat the end of the existing list.\n\n### items\n\nnon-null Array of non-null [cast.framework.messages.QueueItem](/cast/docs/reference/web_receiver/cast.framework.messages.QueueItem)\n\nList of queue items. The itemId field of the items should be empty. It is\nsorted (first element will be played first).\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)"]]
