סקירה כללית
הכיתה שמנהלת את תהליך הגילוי של המכשירים.
GCKDiscoveryManager מנהל אוסף של GCKDeviceProvider מופעים של מחלקה משנית, שכל אחד מהם אחראי לאיתור מכשירים מסוג מסוים. הוא גם כולל רשימה של המכשירים שהתגלו לפי הסדר המילולי.
ה-framework מתחיל את תהליך הגילוי באופן אוטומטי כשהאפליקציה עוברת לחזית ומשהה אותו כשהאפליקציה עוברת לרקע. בדרך כלל, לאפליקציה אין צורך לקרוא ל-startDiscovery (GCKDiscoveryManager) ול-stopDiscovery (GCKDiscoveryManager), מלבד כאמצעי אופטימיזציה לצמצום התנועה ברשת וניצול המעבד (CPU) באזורים באפליקציה שלא משתמשים בפונקציונליות של העברה (cast).
אם האפליקציה משתמשת בתיבת הדו-שיח 'העברה' של המסגרת באמצעות GCKUICastButton או על ידי הצגה ישירה שלה, בתיבת הדו-שיח הזו ייעשה שימוש ב-GCKDiscoveryManager כדי לאכלס את רשימת המכשירים הזמינים. אם האפליקציה מספקת ממשק משתמש משלה לניהול תיבת דו-שיח לבחירת מכשיר או לתיבת דו-שיח, עליה להשתמש ב-GCKDiscoveryManager ובפרוטוקול ה-listener שמשויך אליו, GCKDiscoveryManagerListener, כדי לאכלס ולעדכן את רשימת המכשירים הזמינים.
- מאז
- 3.0
יורש את NSObject.
סיכום שיטות של מכונה | |
| (instancetype) | - init |
| מאתחל ברירת המחדל לא זמין. עוד... | |
| (void) | - addListener: |
| הוספת מאזינים שיקבלו התראות על גילוי תכנים. עוד... | |
| (void) | - removeListener: |
| הסרת מאזין שנרשם בעבר. עוד... | |
| (void) | - startDiscovery |
| התחלת תהליך הגילוי. עוד... | |
| (void) | - stopDiscovery |
| לחיצה על הלחצן תעצור את תהליך הגילוי. עוד... | |
| (BOOL) | - isDiscoveryActiveForDeviceCategory: |
| הפונקציה בודקת אם הגילוי פעיל כרגע לגבי קטגוריית המכשירים הנתונה. עוד... | |
| (GCKDevice *) | - deviceAtIndex: |
| מחזירה את המכשיר באינדקס הנתון ברשימת המכשירים שנמצאו של המנהל. עוד... | |
| (nullable GCKDevice *) | - deviceWithUniqueID: |
| מחזירה את המכשיר עם המזהה הייחודי הנתון ברשימת המכשירים שנמצאו בחשבון הניהול. עוד... | |
| (void) | - findDeviceWithUniqueID:timeout:completion: |
| ממתין לזיהוי מכשיר עם המזהה הייחודי הנתון, ומפעיל חסימת השלמה. עוד... | |
| (void) | - cancelFindOperation |
| מבטל כל פעולת חיפוש בתהליך שהתחילה על ידי findDeviceWithUniqueID:timeout:complete:. עוד... | |
סיכום הנכס | |
| GCKDiscoveryState | discoveryState |
| מצב הגילוי הנוכחי. עוד... | |
| BOOL | hasDiscoveredDevices |
| סימון שמציין אם מכשירים כלשהם התגלו על ידי אחד מספקי הגילוי שמנוהלים על ידי האובייקט הזה. עוד... | |
| BOOL | passiveScan |
| סימון שמציין אם הגילוי צריך להשתמש בסריקה "פסיבית". עוד... | |
| BOOL | discoveryActive |
| סימון שמציין אם הגילוי פעיל או לא. עוד... | |
| NSUInteger | deviceCount |
| מספר המכשירים שנמצאו כרגע. עוד... | |
פרטי השיטה
| - (instancetype) init |
מאתחל ברירת המחדל לא זמין.
| - (void) addListener: | (id< GCKDiscoveryManagerListener >) | listener |
הוספת מאזינים שיקבלו התראות על גילוי תכנים.
ה-listener שצורף מוחזק חלש וצריך לשמור אותו כדי להימנע משיתוף פעולה בלתי צפוי.
- Parameters
-
listener The listener to add.
| - (void) removeListener: | (id< GCKDiscoveryManagerListener >) | listener |
הסרת מאזין שנרשם בעבר.
- Parameters
-
listener The listener to remove.
| - (void) startDiscovery |
התחלת תהליך הגילוי.
| - (void) stopDiscovery |
לחיצה על הלחצן תעצור את תהליך הגילוי.
| - (BOOL) isDiscoveryActiveForDeviceCategory: | (NSString *) | deviceCategory |
הפונקציה בודקת אם הגילוי פעיל כרגע לגבי קטגוריית המכשירים הנתונה.
| - (GCKDevice *) deviceAtIndex: | (NSUInteger) | index |
מחזירה את המכשיר באינדקס הנתון ברשימת המכשירים שנמצאו של המנהל.
| - (nullable GCKDevice *) deviceWithUniqueID: | (NSString *) | uniqueID |
מחזירה את המכשיר עם המזהה הייחודי הנתון ברשימת המכשירים שנמצאו בחשבון הניהול.
- Parameters
-
uniqueID The device's unique ID.
- החזרות
- האובייקט התואם ב-GCKDevice, או
nilאם לא נמצא מכשיר תואם.
| - (void) findDeviceWithUniqueID: | (NSString *) | uniqueID | |
| timeout: | (NSTimeInterval) | timeout | |
| completion: | (void(^)(GCKDevice *)) | completion | |
ממתין לזיהוי מכשיר עם המזהה הייחודי הנתון, ומפעיל חסימת השלמה.
אם מכשיר תואם כבר נמצא ברשימת המכשירים שנמצאו, חסימת ההשלמה תופעל באופן מיידי (אבל אחרי שהשיטה הזו תחזור). רק פעולת חיפוש אחת יכולה להיות פעילה בכל פעם. התחלת פעולת חיפוש חדשה בזמן שמתבצעת פעולה אחרת תבטל את הפעולה הנוכחית.
- Parameters
-
uniqueID The unique ID of the device. timeout The maximum amount of time to wait for the device to be discovered. completion The completion block to invoke when either the device is found or the timeout is reached. The device (if found) or nil(if not found) will be passed to the completion block.
- מאז
- 4.0
| - (void) cancelFindOperation |
מבטל כל פעולת חיפוש בתהליך שהתחילה על ידי findDeviceWithUniqueID:timeout:complete:.
- מאז
- 4.0
פרטי הנכס
|
readnonatomicassign |
מצב הגילוי הנוכחי.
|
readnonatomicassign |
סימון שמציין אם מכשירים כלשהם התגלו על ידי אחד מספקי הגילוי שמנוהלים על ידי האובייקט הזה.
|
readwritenonatomicassign |
סימון שמציין אם הגילוי צריך להשתמש בסריקה "פסיבית".
סריקות פסיביות דורשות פחות משאבים, אבל לא מספקות תוצאות עדכניות כמו הסריקות הפעילות.
|
readnonatomicassign |
סימון שמציין אם הגילוי פעיל או לא.
- מאז
- 3.4
|
readnonatomicassign |
מספר המכשירים שנמצאו כרגע.