סקירה כללית
כיתה שמנהלת סשנים.
השיטה startSessionWithDevice: (GCKSessionManager) משמשת ליצירת סשן חדש עם GCKDevice נתון. מנהל הסשנים משתמש ב-GCKDeviceProvider עבור סוג המכשיר הזה כדי ליצור אובייקט GCKSession חדש, שאליו הוא מעביר את כל בקשות הסשן.
GCKSessionManager מטפל בהמשך אוטומטי של סשנים מושהים (כלומר, המשך של סשנים שהסתיימו כשהאפליקציה עברה לרקע, או במקרה שהאפליקציה קרסה או שהמשתמש סגר אותה בכוח). כשהאפליקציה ממשיכה לפעול או מופעלת מחדש, מנהל הסשנים ימתין זמן קצר עד שספק המכשיר של המכשיר בסשן שהושעה יגלה את המכשיר הזה שוב, ואם הוא יגלה אותו, הוא ינסה להתחבר למכשיר הזה מחדש ולהקים את הסשן מחדש באופן אוטומטי.
אם האפליקציה יצרה GCKUICastButton בלי לספק יעד ובורר, הקשה של משתמש על הלחצן תציג את תיבת הדו-שיח של Cast שמוגדרת כברירת מחדל, והיא תתחיל ותסיים סשנים באופן אוטומטי על סמך הבחירה של המשתמש או הניתוק של המכשיר. עם זאת, אם האפליקציה מספקת ממשק משתמש משלה לדיאלוג של בחירת מכשיר או שליטה במכשיר, היא צריכה להשתמש ישירות ב-GCKSessionManager כדי ליצור סשנים ולשלוט בהם.
גם אם האפליקציה משתמשת ב-GCKSessionManager כדי לשלוט בסשנים וגם אם לא, היא יכולה לצרף GCKSessionManagerListener כדי לקבל הודעות על אירועים שקשורים לסשנים, והיא יכולה גם להשתמש ב-KVO כדי לעקוב אחרי הנכס connectionState ולראות את המצב הנוכחי של מחזור החיים של הסשן.
- מאז
- 3.0
המחלקות האלה יורשות מ-NSObject.
סיכום שיטות המופע | |
(instancetype) | - init |
המאחלים שמוגדר כברירת מחדל לא זמין. עוד... | |
(BOOL) | - startSessionWithDevice: |
מתחיל סשן חדש עם המכשיר הנתון. עוד... | |
(BOOL) | - suspendSessionWithReason: |
השעיית הסשן הנוכחי. עוד... | |
(BOOL) | - endSession |
סיום הסשן הנוכחי. עוד... | |
(BOOL) | - endSessionAndStopCasting: |
הפעולה מסיימת את הסשן הנוכחי, ויש אפשרות להפסיק את ההפעלה ב-Cast. עוד... | |
(BOOL) | - hasConnectedSession |
בודקת אם סשן מנוהל כרגע על ידי מנהל הסשנים הזה, ואם הוא מחובר כרגע. עוד... | |
(BOOL) | - hasConnectedCastSession |
בודקת אם סשן Cast מנוהל כרגע על ידי מנהל הסשנים הזה, ואם הוא מחובר כרגע. עוד... | |
(void) | - addListener: |
מוסיף מאזין לקבלת התראות. עוד... | |
(void) | - removeListener: |
מסיר מאזין שנוסף קודם באמצעות addListener:. עוד... | |
סיכום הנכס | |
GCKSession * | currentSession |
הסשן הנוכחי, אם יש כזה. עוד... | |
GCKCastSession * | currentCastSession |
סשן ה-Cast הנוכחי, אם קיים. עוד... | |
GCKConnectionState | connectionState |
מצב החיבור של הסשן הנוכחי. עוד... | |
פרטי השיטה
- (instancetype) init |
המאחלים שמוגדר כברירת מחדל לא זמין.
- (BOOL) startSessionWithDevice: | (GCKDevice *) | device |
מתחיל סשן חדש עם המכשיר הנתון.
זוהי פעולה אסינכרונית.
- Parameters
-
device The device to use for this session.
- החזרות
YES
אם הפעולה התחילה בהצלחה,NO
אם יש סשן שמוגדר כרגע או אם אי אפשר להתחיל את הפעולה.
- (BOOL) suspendSessionWithReason: | (GCKConnectionSuspendReason) | reason |
השעיית הסשן הנוכחי.
זוהי פעולה אסינכרונית.
- Parameters
-
reason The reason for the suspension.
- החזרות
YES
אם הפעולה התחילה בהצלחה,NO
אם אין סשן פעיל כרגע או אם אי אפשר להתחיל את הפעולה.
- (BOOL) endSession |
סיום הסשן הנוכחי.
זוהי פעולה אסינכרונית.
- החזרות
YES
אם הפעולה התחילה בהצלחה,NO
אם אין סשן פעיל כרגע או אם אי אפשר להתחיל את הפעולה.
- (BOOL) endSessionAndStopCasting: | (BOOL) | stopCasting |
הפעולה מסיימת את הסשן הנוכחי, ויש אפשרות להפסיק את ההפעלה ב-Cast.
זוהי פעולה אסינכרונית.
- Parameters
-
stopCasting Whether casting of content on the receiver should be stopped when the session is ended.
- החזרות
YES
אם הפעולה התחילה בהצלחה,NO
אם אין סשן פעיל כרגע או אם אי אפשר להתחיל את הפעולה.
- (BOOL) hasConnectedSession |
בודקת אם סשן מנוהל כרגע על ידי מנהל הסשנים הזה, ואם הוא מחובר כרגע.
הערך יהיה YES
אם מצב הסשן הוא GCKConnectionStateConnected.
- (BOOL) hasConnectedCastSession |
בודקת אם סשן Cast מנוהל כרגע על ידי מנהל הסשנים הזה, ואם הוא מחובר כרגע.
הערך יהיה YES
אם מצב הסשן הוא GCKConnectionStateConnected והסשן הוא סשן Cast.
- (void) addListener: | (id< GCKSessionManagerListener >) | listener |
מוסיף מאזין לקבלת התראות.
- Parameters
-
listener The listener to add.
- (void) removeListener: | (id< GCKSessionManagerListener >) | listener |
מסיר מאזין שנוסף קודם באמצעות addListener:.
- Parameters
-
listener The listener to remove.
פרטי הנכס
|
readnonatomicstrong |
הסשן הנוכחי, אם יש כזה.
|
readnonatomicstrong |
סשן ה-Cast הנוכחי, אם קיים.
|
readnonatomicassign |
מצב החיבור של הסשן הנוכחי.