המתנה בתור

ה-Cast framework מספק ממשקי API של תור שתומכים ביצירת רשימות של פריטי תוכן, כמו וידאו או אודיו בסטרימינג, לצורך הפעלה רצופה ב-מקלט באינטרנט. אפשר לערוך, לשנות את הסדר של פריטי התוכן, לעדכן אותם וכו'.

הערה: עיינו בשיטות המומלצות בהפעלה האוטומטית של Google Cast לעיצוב הפעלה אוטומטית או הוספה לתור ל-Cast.

ה-Web Receiver SDK שומר על התור ומגיב לפעולות בתור, כל עוד בתור כולל לפחות פריט אחד שפעיל כרגע (מופעל או מושהה). שולחים יכולים להצטרף לפעילות ולהוסיף פריטים לתור. המקבל שומר על סשן של הפריטים בתור עד שהפריט האחרון יסיים את ההפעלה, או שהשולח יפסיק את ההפעלה ויסיים את הסשן, או עד שהשולח יטען תור חדש אצל המקבל. כברירת מחדל, המקבל לא שומר מידע על תורים שנסגרו. ברגע שהפריט האחרון בתור יסתיים, הפעלת המדיה תסתיים והתור ייעלם.

הערה: מקלטי המסוגנן והברירת המחדל של מדיה תומכים רק בתור של שידורי אודיו או וידאו בסטרימינג. כדי להשתמש בתור של תמונות, צריך לפתח Custom Receiver.

יצירה וטעינה של פריטים בתור של מדיה

ב-iOS, פריט בתור של מדיה מיוצג במסגרת ההעברה כמכונה אחת (GCKMediaQueueItem). כשיוצרים פריט של תור מדיה עם תוכן מותאם, ניתן להגדיר את זמן הטעינה מראש כך שהנגן יוכל להתחיל לאחסן את הפריט בתור של מדיה לפני שהפריט שלפניו בתור יסתיים לפעול. מידע נוסף על טעינה מראש זמין במדריך לטעינה מראש של מקלט האינטרנט.

אם מאפיין ההפעלה האוטומטית של הפריט מוגדר כ-True, למקלט האינטרנט יש אפשרות להפעיל אותו באופן אוטומטי. לדוגמה, תוכל להשתמש בדפוס של הכלי ליצירת פריט בתור המדיה, באופן הבא:

Swift

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];

טוענים מערך של פריטים בתור של מדיה בתור באמצעות השיטה queueLoadItems המתאימה מהמחלקה GCKRemoteMediaClient.

קבלת עדכון הסטטוס של תור המדיה

כשמקלט האינטרנט טוען פריט תור של מדיה, הוא מקצה מזהה ייחודי לפריט שנשאר במהלך ההפעלה (וכל משך חיי התור). אתם יכולים לראות מה הסטטוס של התור שמציין איזה פריט נטען כרגע (יכול להיות שהוא לא פועל), נטען או נטען מראש. ניתן גם לקבל רשימה ממוינת של כל הפריטים בתור. פרטי הסטטוס מוצגים במחלקה GCKMediaStatus:

• preloadedItemID – המזהה של הפריט שנטען מראש כרגע, אם יש כזה.
• loadingItemID – המזהה של הפריט שנטען כרגע,
• currentItemID – המזהה של הפריט הנוכחי בתור, אם יש כזה.
• השיטה queueItemCount – מחזירה את מספר הפריטים בתור ההפעלה.
• queueItemAtIndex – הצגת הפריט באינדקס שצוין בתור ההפעלה.

משתמשים בחברים האלה יחד עם שאר החברים בסטטוס המדיה, כדי לעדכן באפליקציה את סטטוס התור והפריטים בתור. בנוסף לעדכוני סטטוס המדיה ממקלט האינטרנט, תוכלו להאזין לשינויים בתור על ידי הטמעת -[remoteMediaClientDidUpdateQueue:] של GCKRemoteMediaClientListener.

הערה: כדי לספק את חוויית המשתמש הטובה ביותר, אפליקציית השולח חייבת להציג את הפריט הבא בהפעלה אוטומטית בתור בממשק המשתמש של השולח.

עריכת התור

כדי לעבוד עם הפריטים בתור, משתמשים בשיטות 'הבאים בתור' של GCKRemoteMediaClient. יש כמה ממשקי API. כך תוכלו לטעון מערך של פריטים לתור חדש, להוסיף פריטים לתור קיים, לעדכן את המאפיינים של הפריטים בתור, לגרום לפריט לעבור קדימה ואחורה בתור, להגדיר את המאפיינים של התור עצמו (לדוגמה, לשנות את repeatMode שבוחר את הפריט הבא), להסיר פריטים מהתור ולשנות את הסדר של הפריטים בתור.