cast.
מידע על הפריטים בתור. ייתכן שמפתחי אפליקציות יצטרכו ליצור QueueItem כדי להוסיף רכיב תור באמצעות cast.framework.messages.InsertQueueItems. במקרה כזה, לא צריך לציין itemId (ה-itemId בפועל יוקצה כשהפריט יתווסף לתור). כך ניתן למנוע התנגשויות בין מזהים לפריטים שנוספו מאפליקציית שולח.
יצרן
QueueItem
new QueueItem(opt_itemId)
פרמטר |
|
|---|---|
|
opt_itemId |
אופציונלי מספר מזהה הפריט |
תכונות
activeTrackIds
(מערך מספרים לא null או לא מוגדר)
מערך של מזהי TrackId פעילים. אם המערך לא יסופק, המסלולים שמוגדרים כברירת מחדל יהיו פעילים.
הפעלה אוטומטית
(בוליאני או לא מוגדר)
אם פרמטר ההפעלה האוטומטית לא צוין או שהוא מוגדר כ-true, נגן המדיה יתחיל להפעיל את הרכיב בתור כשהפריט יהפוך לפריט הנוכחי.
customData
(אובייקט null או לא מוגדר)
האפליקציה יכולה להגדיר כל מידע נוסף נחוץ בתור פריט.
itemId
(מספר או לא מוגדר)
המזהה הייחודי של הפריט בתור. המאפיין הוא אופציונלי כי אין לספק עבור LOAD או INSERT (מכיוון שהנמען יקצה אותו בפעם הראשונה שהפריט נוצר או מוזן בו).
media
(ללא ערך null בכתובת cast.framework.messages.MediaInformation או לא מוגדר)
מטא נתונים (כולל contentId) של רכיב הפלייליסט.
orderId
(מספר או לא מוגדר)
משמש למעקב אחר הסדר המקורי של פריט בתור כדי לבטל את ההשמעה האקראית.
preloadTime
(מספר או לא מוגדר)
הפרמטר הזה הוא רמז לנמען לטעון מראש את פריט המדיה הזה לפני ההפעלה שלו. כך אפשר לעבור בצורה חלקה בין הפריטים שמופעלים מהתור. הזמן מצוין בשניות, ביחס לתחילת ההפעלה של הפריט (בדרך כלל סוף ההפעלה של הפריט הקודם). לדוגמה, אם הערך הוא 10 שניות, הפריט הזה ייטען מראש 10 שניות לפני שהפריט הקודם יסתיים. המקבל ינסה לכבד את הערך הזה אבל לא יבטיח אותו. לדוגמה, אם הערך גדול ממשך הזמן של הפריט הקודם, המקבל יכול לטעון מראש את הפריט זמן קצר אחרי שהפריט הקודם כבר התחיל לפעול (לעולם לא תתבצע טעינה מראש של שני פריטים במקביל). כמו כן, אם פריט יתווסף לתור מיד אחרי הפריט הנוכחי, והזמן לטעינה מראש ארוך יותר מהזמן שנותר לפריט הנוכחי, הטעינה מראש תתבצע בהקדם האפשרי. ערכים שליליים משביתים במפורש את הטעינה מראש. אם הערך הוא 0 או לא מוגדר, פריט המדיה יתחיל להיטען מראש מיד אחרי ההורדה המלאה של הפריט הקודם לאחר מיקום ההפעלה.
startTime
(מספר או לא מוגדר)
שניות מתחילת התוכן. אם התוכן הוא תוכן בשידור חי, ולא צוין זמן התחלה, השידור יתחיל במיקום השידור החי.