آرایه TrackIds که باید فعال باشند. اگر آرایه ارائه نشده باشد، آهنگ های پیش فرض فعال خواهند بود. اگر دو trackId ناسازگار ارائه شود (مثلاً دو تراک صوتی فعال)، فرمان با INVALID_PARAMETER ناموفق خواهد بود.
پخش خودکار
بولی
اینکه آیا رسانه به طور خودکار پخش می شود یا خیر.
داده های سفارشی
شیء پوچ
مجموعه داده های سفارشی توسط برنامه گیرنده.
شناسه مورد
عدد پوچ
شناسه منحصر به فرد مورد در صف. اگر در chrome.cast.media.QueueLoad یا chrome.cast.media.QueueInsert استفاده می شود، باید تهی باشد (زیرا زمانی که یک مورد برای اولین بار ایجاد/درج می شود توسط گیرنده تخصیص داده می شود). برای سایر عملیات اجباری است.
مدت زمان پخش مورد بر حسب ثانیه. اگر بزرگتر از مدت زمان واقعی باشد - startTime به مدت زمان واقعی - startTime محدود می شود. ممکن است منفی باشد، در چنین مواردی مدت زمان مورد نظر، مدت زمان واقعی کالا منهای مدت زمان ارائه شده خواهد بود. مدت زمان مقدار صفر در واقع به این معنی است که آیتم پخش نخواهد شد.
preloadTime
عدد
این پارامتر اشاره ای به گیرنده برای بارگذاری مجدد این آیتم رسانه قبل از پخش آن است. این امکان انتقال صاف بین آیتم های پخش شده از صف را فراهم می کند.
زمان بر حسب ثانیه، نسبت به ابتدای پخش این آیتم (معمولاً پایان پخش آیتم قبلی) بیان می شود. فقط مقادیر مثبت معتبر هستند. به عنوان مثال، اگر مقدار 10 ثانیه باشد، این مورد 10 ثانیه قبل از اتمام آیتم قبلی از قبل بارگذاری می شود. گیرنده سعی می کند این مقدار را رعایت کند اما آن را تضمین نمی کند، به عنوان مثال اگر مقدار از مدت زمان مورد قبلی بیشتر باشد، گیرنده ممکن است این مورد را مدت کوتاهی پس از شروع پخش آیتم قبلی از قبل بارگذاری کند (هرگز دو مورد از قبل بارگذاری نمی شوند. به موازات). همچنین، اگر یک آیتم درست بعد از currentItem در صف قرار گیرد و زمان پیش بارگذاری بیشتر از زمان باقی مانده در currentItem باشد، پیش بارگذاری در اسرع وقت انجام می شود.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
