Tableau des ID de suivi qui doivent être actifs. Si le tableau n'est pas fourni, les pistes par défaut seront actives.
Si deux trackId non compatibles sont fournis (par exemple, deux pistes audio actives), la commande échoue et renvoie INVALID_PARAMETER.
lecture automatique
boolean
Indique si le contenu multimédia est lu automatiquement.
customData
Objet pouvant avoir une valeur nulle
Ensemble de données personnalisées par l'application réceptrice.
itemId
nombre pouvant avoir une valeur nulle
Identifiant unique de l'élément de la file d'attente. S'il est utilisé dans chrome.cast.media.QueueLoad ou chrome.cast.media.QueueInsert, il doit être nul (car il sera attribué par le destinataire la première fois qu'un élément sera créé/inséré). Pour les autres opérations, il est obligatoire.
Durée de lecture de l'élément en secondes. Si elle est supérieure à la durée réelle (startTime), elle sera limitée à la durée réelle (startTime). Elle peut être négative. Dans ce cas, la durée correspond à la durée réelle de l'élément moins la durée fournie. Une durée de valeur "zéro" signifie que l'élément ne sera pas lu.
preloadTime
number
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). Seules les valeurs positives sont valides. 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 elle est supérieure à la durée de l'élément précédent, il peut simplement 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.
startTime
number
Nombre de secondes écoulées à partir du début du contenu multimédia avant le lancement de la lecture.
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\u003echrome.cast.media.QueueItem\u003c/code\u003e represents an item within a media queue, like a song in a playlist.\u003c/p\u003e\n"],["\u003cp\u003eIt's constructed using \u003ccode\u003emediaInfo\u003c/code\u003e, which describes the media (e.g., title, artist).\u003c/p\u003e\n"],["\u003cp\u003eKey properties include \u003ccode\u003emedia\u003c/code\u003e, \u003ccode\u003estartTime\u003c/code\u003e, \u003ccode\u003eplaybackDuration\u003c/code\u003e, and \u003ccode\u003eautoplay\u003c/code\u003e, allowing control over playback.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003epreloadTime\u003c/code\u003e hints to the receiver to preload the item for smoother transitions.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eactiveTrackIds\u003c/code\u003e enables specifying active tracks (like subtitles or audio languages).\u003c/p\u003e\n"]]],["A `QueueItem` represents an item in a media queue and requires `mediaInfo`. Key properties include: `activeTrackIds` (tracks to be active), `autoplay` (automatic playback), `customData` (application-specific data), `itemId` (unique identifier), `media` (media description), `playbackDuration` (playback time), `preloadTime` (time to preload before playback), and `startTime` (playback start time). `itemId` must be null when creating but mandatory for other operations. `preloadTime` hints when to load next.\n"],null,["# Class: QueueItem\n\nchrome.[cast](/cast/docs/reference/web_sender/chrome.cast).[media](/cast/docs/reference/web_sender/chrome.cast.media).QueueItem\n===============================================================================================================================\n\nclass static\n\nRepresents an item in a media queue.\n\nConstructor\n-----------\n\n### QueueItem\n\nnew\nQueueItem(mediaInfo)\n\n| #### Parameter ||\n|-----------|-------------------------------------------------------------------------------------------------------------------------------|\n| mediaInfo | [chrome.cast.media.MediaInfo](/cast/docs/reference/web_sender/chrome.cast.media.MediaInfo) Media info Value must not be null. |\n\nProperties\n----------\n\n### activeTrackIds\n\nnullable Array of number\n\nArray of Track trackIds that should be active. If the array is not\nprovided, the default tracks will be active.\nIf two incompatible trackIds are provided (for example two active audio\ntracks) the command will fail with INVALID_PARAMETER.\n\n### autoplay\n\nboolean\n\nWhether the media will automatically play.\n\n### customData\n\nnullable Object\n\nCustom data set by the receiver application.\n\n### itemId\n\nnullable number\n\nUnique identifier of the item in the queue. If used in\nchrome.cast.media.QueueLoad or chrome.cast.media.QueueInsert it must be\nnull (as it will be assigned by the receiver when an item is first\ncreated/inserted). For other operations it is mandatory.\n\n### media\n\nnon-null [chrome.cast.media.MediaInfo](/cast/docs/reference/web_sender/chrome.cast.media.MediaInfo)\n\nMedia description.\n\n### playbackDuration\n\nnullable number\n\nPlayback duration of the item in seconds. If it is larger than the actual\nduration - startTime it will be limited to the actual duration -\nstartTime. It can be negative, in such case the duration will be the\nactual item duration minus the duration provided. A duration of value\nzero effectively means that the item will not be played.\n\n### preloadTime\n\nnumber\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.\n\nThe time is expressed in seconds, relative to\nthe beginning of this item playback (usually the end of the previous item\nplayback). Only positive values are valid. For example, if the value is\n10 seconds, this item will be preloaded 10 seconds before the previous\nitem has finished. The receiver will try to honor this value but will not\nguarantee it, for example if the value is larger than the previous item\nduration the receiver may just preload this item shortly after the\nprevious item has started playing (there will never be two items being\npreloaded in parallel). Also, if an item is inserted in the queue just\nafter the currentItem and the time to preload is higher than the time\nleft on the currentItem, the preload will just happen as soon as\npossible.\n\n### startTime\n\nnumber\n\nSeconds from the beginning of the media to start playback."]]
