Matriz de trackIds de faixas que devem estar ativos. Se a matriz não for
fornecida, as faixas padrão ficarão ativas.
Se dois trackIds incompatíveis forem fornecidos (por exemplo, duas faixas de áudio ativas), o comando falhará com INVALID_PARAMETER.
reprodução automática
boolean
Define se a mídia será reproduzida automaticamente.
customData
objeto anulável
Dados personalizados definidos pelo app receptor.
itemId
número anulável
Identificador exclusivo do item na fila Se usado em chrome.cast.media.QueueLoad ou chrome.cast.media.QueueInsert, ele precisará ser nulo (porque será atribuído pelo receptor quando um item for criado/inserido pela primeira vez). Para outras operações, ele é obrigatório.
Duração da reprodução do item em segundos. Se for maior que a duração real - startTime, ela será limitada à duração real - startTime. Ela pode ser negativa. Nesse caso, a duração será a duração real do item menos a duração fornecida. Uma duração de valor zero significa que o item não será reproduzido.
preloadTime
number
Esse parâmetro é uma dica para o receptor pré-carregar esse item de mídia antes que ele seja reproduzido. Ele permite uma transição suave entre os itens
reproduzidos na fila.
O tempo é expresso em segundos, relativo ao início da reprodução do item (geralmente o fim da reprodução anterior do item). Somente valores positivos são válidos. Por exemplo, se o valor for de
10 segundos, esse item será pré-carregado 10 segundos antes da conclusão do
item anterior. O receptor tentará respeitar esse valor, mas não o garantirá. Por exemplo, se o valor for maior que a duração anterior do item, o receptor poderá apenas pré-carregar esse item logo após o início da reprodução do item anterior (não haverá dois itens sendo pré-carregados em paralelo). Além disso, se um item for inserido na fila logo após o currentItem e o tempo de pré-carregamento for maior que o tempo restante no currentItem, o pré-carregamento acontecerá o mais rápido possível.
[null,null,["Última atualização 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."]]
