Mảng mã theo dõi cần hoạt động. Nếu bạn không cung cấp mảng, các kênh mặc định sẽ hoạt động.
Nếu bạn cung cấp 2 mã theo dõi không tương thích (ví dụ: 2 bản âm thanh đang hoạt động), thì lệnh sẽ không thành công với INVALID_param.
tự động phát
boolean
Liệu nội dung nghe nhìn có tự động phát hay không.
customData
Đối tượng rỗng
Dữ liệu tuỳ chỉnh do ứng dụng nhận tập hợp.
itemId
số rỗng
Giá trị nhận dạng duy nhất của mục trong hàng đợi. Nếu được dùng trong chrome.cast.media.QueueLoad hoặc chrome.cast.media.QueueInsert thì giá trị này phải có giá trị rỗng (vì giá trị này sẽ do trình nhận chỉ định khi tạo/chèn một mục lần đầu). Đối với các thao tác khác, thao tác này là bắt buộc.
Thời lượng phát của mục tính bằng giây. Nếu thời lượng này lớn hơn thời lượng thực tế – startTime, thì thời lượng này sẽ bị giới hạn trong thời lượng thực tế – startTime. Giá trị này có thể là số âm, trong trường hợp đó, thời lượng sẽ bằng
thời lượng thực tế của mặt hàng trừ đi thời lượng đã cung cấp. Thời lượng có giá trị bằng 0 có nghĩa là mục đó sẽ không được phát.
preloadTime
number
Tham số này là gợi ý để trình thu tải tải trước mục nội dung đa phương tiện này trước khi phát. Nhờ vậy, quá trình chuyển đổi giữa các mục được phát trong hàng đợi sẽ diễn ra suôn sẻ.
Thời gian được biểu thị bằng giây, tương ứng với thời điểm bắt đầu phát mục này (thường là thời điểm kết thúc phát mục trước đó). Chỉ các giá trị dương mới hợp lệ. Ví dụ: nếu giá trị là 10 giây, mục này sẽ được tải trước 10 giây trước khi mục trước kết thúc. Trình thu nhận sẽ cố gắng tuân thủ giá trị này nhưng không đảm bảo, ví dụ: nếu giá trị lớn hơn thời lượng mục trước đó, thì trình thu có thể chỉ tải trước mục này ngay sau khi mục trước đó bắt đầu phát (sẽ không bao giờ có hai mục được tải trước song song). Ngoài ra, nếu một mục được chèn vào hàng đợi ngay sau currentItem và thời gian tải trước lâu hơn thời gian còn lại của currentItem, thì việc tải trước sẽ chỉ diễn ra càng sớm càng tốt.
startTime
number
Số giây tính từ đầu nội dung nghe nhìn để bắt đầu phát.
[null,null,["Cập nhật lần gần đây nhất: 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."]]
