מסגרת Cast מספקת ממשקי API של 'הבאים בתור' שתומכים ביצירת רשימות של פריטי תוכן, כגון שידורי וידאו או אודיו, להפעלה ברצף באינטרנט מקלט. אפשר לערוך, לשנות את הסדר של הפריטים בתור, לעדכן אותם וכו' הלאה.
ה-SDK של מקבל האינטרנט שומר על התור ומגיב לפעולות כל עוד התור כולל לפחות פריט אחד פעיל (מופעל או מושהה). השולחים יוכלו להצטרף לסשן ולהוסיף פריטים לתור. המקבל שומר הפעלה של פריטים בתור עד שהפריט האחרון מסיים את ההפעלה, או השולח עוצר את ההפעלה ומסיים את הסשן, או עד שהשולח טוען תור חדש במקלט. המקבל לא שומר על תורים שנסגרו כברירת מחדל. לאחר הפריט האחרון בתור מסתיים, סשן המדיה מסתיים והתור נעלם.
יצירה וטעינה של פריטים בתור המדיה
ב-iOS, פריט בתור מדיה מיוצג במסגרת Cast בתור
מופע אחד (GCKMediaQueueItem
).
כשיוצרים פריט בתור מדיה עם תוכן מותאם, אפשר להגדיר
זמן הטעינה מראש כדי שהנגן יוכל להתחיל בתהליך אגירת הנתונים של הפריט בתור המדיה לפני
הפריט שלפניו בתור מסיים להשמיע. מידע נוסף על טעינה מראש ב-
ה
מדריך לטעינה מראש של מקלט אינטרנט.
הגדרת ההפעלה האוטומטית של הפריט המאפיין True מאפשר למקלט האינטרנט להפעיל אותו באופן אוטומטי. לדוגמה, אפשר להשתמש בתבנית builder כדי ליצור את הפריט בתור המדיה באופן הבא:
let builder = GCKMediaQueueItemBuilder.init() builder.mediaInformation = mediaInformation builder.autoplay = true builder.preloadTime = 8.0 let newItem = builder.build()
GCKMediaQueueItemBuilder *builder = [[GCKMediaQueueItemBuilder alloc] init]; builder.mediaInformation = self.mediaInformation; builder.autoplay = YES; builder.preloadTime = 8.0; GCKMediaQueueItem *newItem = [builder build];
טוענים מערך של פריטים בתור המדיה בתור באמצעות
ה-method queueLoadItems
GCKRemoteMediaClient
בכיתה.
קבלת עדכון הסטטוס של 'הבאים בתור המדיה'
כשמקלט האינטרנט טוען פריט בתור מדיה, הוא מקצה מזהה ייחודי
פריט שנשאר למשך כל ההפעלה (וכל משך החיים של התור).
אפשר לבדוק את הסטטוס של התור שמציין איזה פריט נטען כרגע
(ייתכן שהוא לא פועל), בטעינה או בטעינה מראש. אתם יכולים גם להזמין
רשימה של כל הפריטים בתור.
GCKMediaStatus
הכיתה מספקת את פרטי הסטטוס הבאים:
preloadedItemID
המאפיין (property) – המזהה של הפריט שנטען מראש, אם יש כזה.loadingItemID
מאפיין - המזהה של הפריט שנטען כרגע,currentItemID
מאפיין - המזהה של הפריט הנוכחי בתור, אם יש כזה.queueItemCount
method - מחזירה את מספר הפריטים בתור ההפעלה.queueItemAtIndex
method - מחזירה את הפריט באינדקס שצוין בתור ההפעלה.
נעזרים בחברים האלה יחד עם חברים אחרים בסטטוס המדיה כדי לעדכן את
על הסטטוס של 'הבאים בתור' והפריטים בתור. נוסף ל-
ניתן לראות עדכונים לגבי סטטוס המדיה ממקלט האינטרנט,
יוצרים תור על ידי הטמעת -[remoteMediaClientDidUpdateQueue:]
GCKRemoteMediaClientListener
.
עריכת התור
כדי לעבוד עם הפריטים בתור, צריך להשתמש בשיטות הבאות בתור
GCKRemoteMediaClient
יש לכם כמה ממשקי API. הם מאפשרים לטעון מערך של פריטים בתור חדש,
להוסיף פריטים לתור קיים, לעדכן את המאפיינים של פריטים
בתור, לגרום לפריט לקפוץ קדימה או אחורה בתור, להגדיר את המאפיינים של
את התור עצמו (לדוגמה, משנים את repeatMode
שבוחר את
), להסיר פריטים מהתור ולשנות את הסדר של הפריטים בתור.