cast.
תור אירוע מדיה: יש להזין נתוני בקשה.
יצרן
QueueInsertRequestData
חדש QueueInsertRequestData(items)
פרמטר |
|
|---|---|
|
items |
מערך של cast.framework.messages.QueueItem שאינו null רשימת פריטים בתור. השדה itemId של הפריטים צריך להיות ריק, אחרת הבקשה תיכשל ותוצג שגיאת INVALID_PARAMS. הוא ממוין (הרכיב הראשון יופעל ראשון). הערך לא יכול להיות ריק. |
תכונות
currentItemId
(מספר או לא מוגדר)
המזהה של פריט המדיה הנוכחי לאחר ההכנסה (אם לא צוין, הערך הנוכחי של הפריט יהיה זהה לערך שהיה לפני ההכנסה).
currentItemIndex
(מספר או לא מוגדר)
האינדקס (יחסית למערך הפריטים, מתחיל ב-0) של פריט המדיה הנוכחי החדש. לפריטים שנוספו אנחנו משתמשים באינדקס (בדומה ל-startIndex ב-QUEUE_LOAD) ולא currentItemId, כי ה-itemId לא ידוע עד שהפריטים יוזנו. אם לא תספקו, הערך הנוכחי של הפריט יהיה זהה לערך שהיה לפני ההכנסה (אלא אם צוין מזהה נוכחי של הפריט). הפרמטר הזה מאפשר להפוך את האטום לתרחיש נפוץ של הוספה והפעלה של פריט.
currentTime
(מספר או לא מוגדר)
שניות מתחילת התוכן ועד התחלת ההפעלה של הפריט הנוכחי. אם סופק, הערך הזה יקבל עדיפות על פני ערך startTime שמצוין ברמה QueueItem אבל רק בפעם הראשונה שהפריט יופעל. מצב זה נועד לכסות את המקרה הנפוץ שבו המשתמש קופץ לאמצע פריט, כך שה-currentTime לא יחול על הפריט באופן קבוע, כמו ש-QueueItem startTime עושה. כך לא תצטרכו לאפס את ה-startTime באופן דינמי (ייתכן שלא ניתן יהיה לבצע את הפעולה אם הטלפון עבר למצב שינה).
customData
(אובייקט לא null או לא מוגדר)
נתונים ספציפיים לאפליקציה לבקשה הזו. היא מאפשרת לשולח ולמקבל להרחיב בקלות את פרוטוקול המדיה, בלי להשתמש במרחב שמות חדש עם הודעות בהתאמה אישית.
insertBefore
(מספר או לא מוגדר)
המזהה של הפריט שימוקם מיד אחרי הרשימה שהוספתם. אם המזהה לא נמצא או שלא צוין, הרשימה תתווסף בסוף הרשימה הקיימת.
items
מערך לא-null של cast.framework.messages.QueueItem שאינו ריק
רשימת פריטים בתור. השדה itemId של הפריטים צריך להיות ריק. הוא ממוין (הרכיב הראשון יופעל ראשון).
mediaSessionId
(מספר או לא מוגדר)
המזהה של סשן המדיה שעליו חלה הבקשה.
requestId
מספר
מזהה הבקשה, משמש להתאמת הבקשה/התגובה.
sequenceNumber
(מספר או לא מוגדר)
מספר לסנכרון כל פקודות התור. אם סופקה פקודת תור, ה-SDK יאמת שמספר הרצף האחרון של תור תואם לבקשה. מספר הרצף הנוכחי מסופק כחלק מההודעות היוצאות שהשתנו.