המתנה בתור

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

הערה: כדאי לקרוא את הפעלה אוטומטית של Google Cast לשחקנים הטובים ביותר כשמתכננים חוויה של הפעלה אוטומטית או הוספה לרשימת 'הבאים בתור' עבור Cast.

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

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

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

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

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

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

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

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

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

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

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

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

עריכת התור

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