מערך של מזהי TrackId שצריכים להיות פעילים. אם המערך לא
יסופק, המסלולים שמוגדרים כברירת מחדל יהיו פעילים.
אם יסופקו שני מזהי TrackId שאינם תואמים (לדוגמה, שני טראקים פעילים של אודיו), הפקודה תיכשל ב-INVALID_PARAMETER.
הפעלה אוטומטית
boolean
אם המדיה תופעל באופן אוטומטי.
customData
אובייקט null
נתונים מותאמים אישית שהוגדרו על ידי האפליקציה המקבלת.
itemId
מספר ריק
המזהה הייחודי של הפריט בתור. אם נעשה בו שימוש
ב-chrome.cast.media.QueueLoad או ב-chrome.cast.media.QueueInsert, הערך חייב להיות null (מכיוון שהוא יוקצה על ידי המקבל במהלך היצירה או ההוספה הראשונה של הפריט). בפעולות אחרות חובה לבצע את האימות.
משך ההפעלה של הפריט בשניות. אם משך הזמן ארוך יותר ממשך הזמן
בפועל – startTime, הוא יוגבל למשך הזמן בפועל –
startTime. הערך יכול להיות שלילי. במקרה כזה, משך הזמן יהיה
משך הזמן בפועל של הפריט, פחות משך הזמן שצוין. משך זמן של ערך
אפס בפועל פירושו שהפריט לא יופעל.
preloadTime
מספר
הפרמטר הזה הוא רמז לנמען לטעון מראש את פריט המדיה הזה
לפני ההפעלה שלו. כך אפשר לעבור בצורה חלקה בין הפריטים
שמופעלים מהתור.
הזמן מצוין בשניות, ביחס לתחילת ההפעלה של הפריט (בדרך כלל סוף ההפעלה של הפריט הקודם). רק ערכים חיוביים הם חוקיים. לדוגמה, אם הערך הוא
10 שניות, הפריט הזה ייטען מראש 10 שניות לפני
הפריט הקודם יסתיים. המקבל ינסה לכבד את הערך הזה
אבל לא יבטיח אותו. לדוגמה, אם הערך גדול ממשך הזמן של הפריט
הקודם, המקבל יכול לטעון מראש את הפריט זמן קצר אחרי
שהפריט הקודם כבר התחיל לפעול (לעולם לא תתבצע טעינה מראש של שני פריטים במקביל). כמו כן, אם פריט יתווסף לתור מיד
אחרי הפריט הנוכחי והזמן לטעינה מראש ארוך יותר מהזמן שנותר לפריט הנוכחי, הטעינה מראש תתבצע בהקדם האפשרי.
[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."]]
