Informations sur les éléments de la file d'attente. Les développeurs d'applications devront peut-être créer un élément QueueItem pour insérer un élément de file d'attente à l'aide de cast.framework.messages.InsertQueueItems. Dans ce cas, ils ne doivent pas fournir d'itemId (car l'itemId réel est attribué lorsque l'article est inséré dans la file d'attente). Cela permet d'éviter les conflits d'ID avec les éléments ajoutés à partir d'une application émettrice.
Constructeur
QueueItem
nouvel élément QueueItem(opt_itemId)
Paramètres
opt_itemId
Facultatif
number
ID de l'élément.
Propriétés
activeTrackIds
(tableau de nombres non nul ou non défini)
Tableau des identifiants de piste actifs. Si le tableau n'est pas fourni, les canaux par défaut seront actifs.
lecture automatique
(booléen ou non défini)
Si le paramètre de lecture automatique n'est pas spécifié ou est défini sur "true", le lecteur multimédia commence à lire l'élément de la file d'attente lorsque celui-ci devient l'élément currentItem.
customData
(objet pouvant avoir une valeur nulle ou non défini)
L'application peut définir toute information supplémentaire nécessaire sur les éléments de la file d'attente.
itemId
(nombre ou non défini)
Identifiant unique de l'élément de la file d'attente. L'attribut est facultatif, car il ne doit pas être défini pour LOAD ou INSERT (car il sera attribué par le destinataire lors de la création/insertion initiale d'un élément).
Métadonnées (y compris contentId) de l'élément de playlist.
orderId
(nombre ou non défini)
Permet de suivre l'ordre d'origine d'un élément de la file d'attente pour annuler la lecture en mode aléatoire.
preloadTime
(nombre ou non défini)
Ce paramètre indique au récepteur de précharger cet élément multimédia avant qu'il ne soit lu. Cela permet une transition en douceur entre les éléments lus à partir de la file d'attente. La durée est exprimée en secondes par rapport au début de la lecture de cet élément (généralement la fin de la lecture de l'élément précédent). Par exemple, si la valeur est de 10 secondes, cet élément est préchargé 10 secondes avant la fin de l'élément précédent. Le récepteur tente de respecter cette valeur, mais ne la garantit pas. Par exemple, si la valeur est supérieure à la durée de l'élément précédent, il peut juste précharger cet élément peu de temps après le début de la lecture de l'élément précédent (deux éléments ne seront jamais préchargés en parallèle). De plus, si un élément est inséré dans la file d'attente juste après l'élément "currentItem" et que le temps de préchargement est supérieur à celui restant pour l'élément "currentItem", le préchargement aura lieu dès que possible. Les valeurs négatives désactivent explicitement le préchargement. Si la valeur est égale à 0 ou n'est pas définie, l'élément multimédia est préchargé dès que l'élément précédent est entièrement téléchargé après sa position de lecture.
startTime
(nombre ou non défini)
Nombre de secondes écoulées depuis le début du contenu. S'il s'agit d'un contenu en direct et que l'heure de début n'est pas spécifiée, le flux commencera à la position du direct.
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\u003eQueueItem\u003c/code\u003e objects represent items within a media queue, holding information like media metadata, playback settings, and custom data.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can create \u003ccode\u003eQueueItem\u003c/code\u003e instances to insert elements into the queue, but should omit the \u003ccode\u003eitemId\u003c/code\u003e for new items to avoid conflicts.\u003c/p\u003e\n"],["\u003cp\u003eKey properties of a \u003ccode\u003eQueueItem\u003c/code\u003e include \u003ccode\u003emedia\u003c/code\u003e for content details, \u003ccode\u003eautoplay\u003c/code\u003e and \u003ccode\u003estartTime\u003c/code\u003e for playback control, and \u003ccode\u003epreloadTime\u003c/code\u003e to optimize transitions.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecustomData\u003c/code\u003e property allows developers to attach application-specific information to queue items for extended functionality.\u003c/p\u003e\n"],["\u003cp\u003eExisting queue items can be identified and managed using their unique \u003ccode\u003eitemId\u003c/code\u003e, assigned by the receiver upon insertion.\u003c/p\u003e\n"]]],["`QueueItem` stores queue element information. Developers create it for inserting queue elements, omitting `itemId` to prevent collisions. Key properties include: `activeTrackIds` (active track IDs), `autoplay` (automatic playback), `customData` (extra data), `media` (metadata), `orderId` (original order), `preloadTime` (preloading hint), and `startTime` (content start time). `itemId` is assigned by the receiver during creation/insertion, and `preloadTime` helps smooth transitions between queued items.\n"],null,["# Class: QueueItem\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).[messages](/cast/docs/reference/web_receiver/cast.framework.messages).QueueItem\n==================================================================================================================================================\n\nclass static\n\nQueue item information. Application developers may need to create a QueueItem\nto insert a queue element using\ncast.framework.messages.InsertQueueItems. In this case they should\nnot provide an itemId (as the actual itemId will be assigned when the item is\ninserted in the queue). This prevents ID collisions with items added from a\nsender app.\n\nConstructor\n-----------\n\n### QueueItem\n\nnew\nQueueItem(opt_itemId)\n\n| #### Parameter ||\n|------------|------------------------------|\n| opt_itemId | Optional number The item ID. |\n\nProperties\n----------\n\n### activeTrackIds\n\n(non-null Array of number or undefined)\n\nArray of Track trackIds that are active. If the array is not provided,\nthe default tracks will be active.\n\n### autoplay\n\n(boolean or undefined)\n\nIf the autoplay parameter is not specified or is true, the media player\nwill begin playing the element in the queue when the item becomes the\ncurrentItem.\n\n### customData\n\n(nullable Object or undefined)\n\nThe application can define any extra queue item information needed.\n\n### itemId\n\n(number or undefined)\n\nUnique identifier of the item in the queue. The attribute is optional\nbecause for LOAD or INSERT should not be provided (as it will be assigned\nby the receiver when an item is first created/inserted).\n\n### media\n\n(non-null [cast.framework.messages.MediaInformation](/cast/docs/reference/web_receiver/cast.framework.messages.MediaInformation) or undefined)\n\nMetadata (including contentId) of the playlist element.\n\n### orderId\n\n(number or undefined)\n\nUsed to track original order of an item in the queue to undo shuffle.\n\n### preloadTime\n\n(number or undefined)\n\nThis parameter is a hint for the receiver to preload this media item\nbefore it is played. It allows for a smooth transition between items\nplayed from the queue. The time is expressed in seconds, relative to the\nbeginning of this item playback (usually the end of the previous item\nplayback). For example, if the value is 10 seconds, this item will be\npreloaded 10 seconds before the previous item has finished. The receiver\nwill try to honor this value but will not guarantee it, for example if\nthe value is larger than the previous item duration the receiver may just\npreload this item shortly after the previous item has started playing\n(there will never be two items being preloaded in parallel). Also, if an\nitem is inserted in the queue just after the currentItem and the time to\npreload is higher than the time left on the currentItem, the preload will\njust happen as soon as possible. Negative values explicitly disable\npreloading. If the value is 0 or undefined, the media item will start to\npreload as soon as the previous item is fully downloaded after its\nplayback position.\n\n### startTime\n\n(number or undefined)\n\nSeconds since beginning of content. If the content is live content, and\nstartTime is not specified, the stream will start at the live position."]]
