활성화해야 하는 트랙 트랙 ID의 배열입니다. 배열이 제공되지 않으면 기본 트랙이 활성화됩니다.
호환되지 않는 트랙 ID 2개가 제공되면 (예: 활성 오디오 트랙 2개) 명령어가 INVALID_PARAMETER와 함께 실패합니다.
자동재생
boolean
미디어의 자동 재생 여부입니다.
customData
null을 허용하는 객체
수신기 애플리케이션에서 설정한 맞춤 데이터 세트입니다.
itemId
null을 허용하는 숫자
큐에 있는 항목의 고유 식별자입니다. chrome.cast.media.QueueLoad 또는 chrome.cast.media.QueueInsert에 사용할 경우 null이어야 합니다 (항목이 처음 생성/삽입될 때 수신기에서 할당되기 때문입니다). 다른 작업의 경우 필수입니다.
항목 재생 시간(초)입니다. 실제 기간(startTime)보다 크면 실제 기간(startTime)으로 제한됩니다. 음수일 수 있으며, 이 경우 기간은 실제 항목 기간에서 제공된 기간을 뺀 값입니다. 지속 시간이 0이면 항목이 재생되지 않음을 의미합니다.
preloadTime
숫자
이 매개변수는 미디어 항목이 재생되기 전에 수신기에서 이 미디어 항목을 미리 로드할 수 있게 하는 힌트입니다. 따라서 대기열에서 재생되는 항목 간에 원활하게 전환할 수 있습니다.
시간은 이 항목 재생의 시작 (일반적으로 이전 항목 재생의 끝)을 기준으로 한 초 단위로 표시됩니다. 양수 값만 유효합니다. 예를 들어 값이 10초이면 이 항목은 이전 항목이 완료되기 10초 전에 미리 로드됩니다. 수신기는 이 값을 적용하려고 하지만 반드시 그런 것은 아닙니다. 예를 들어 값이 이전 항목 기간보다 큰 경우 수신기는 이전 항목이 재생을 시작한 직후에 이 항목을 미리 로드할 수 있습니다 (항목 두 개가 동시에 미리 로드되지 않음). 또한 currentItem 직후에 항목이 큐에 삽입되고 미리 로드하는 시간이 currentItem에 남은 시간보다 긴 경우 미리 로드가 최대한 빨리 발생합니다.
[null,null,["최종 업데이트: 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."]]
