מחלקת GCKDiscoveryManager

חומר עזר למחלקה של GCKDiscoveryManager

סקירה כללית

הכיתה שמנהלת את תהליך הגילוי של המכשירים.

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
listenerThe listener to add.
- (void) removeListener: (id< GCKDiscoveryManagerListener >)  listener

הסרת מאזין שנרשם בעבר.

Parameters
listenerThe listener to remove.
- (void) startDiscovery

התחלת תהליך הגילוי.

- (void) stopDiscovery

לחיצה על הלחצן תעצור את תהליך הגילוי.

- (BOOL) isDiscoveryActiveForDeviceCategory: (NSString *)  deviceCategory

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

- (GCKDevice *) deviceAtIndex: (NSUInteger)  index

מחזירה את המכשיר באינדקס הנתון ברשימת המכשירים שנמצאו של המנהל.

- (nullable GCKDevice *) deviceWithUniqueID: (NSString *)  uniqueID

מחזירה את המכשיר עם המזהה הייחודי הנתון ברשימת המכשירים שנמצאו בחשבון הניהול.

Parameters
uniqueIDThe device's unique ID.
החזרות
האובייקט התואם ב-GCKDevice, או nil אם לא נמצא מכשיר תואם.
- (void) findDeviceWithUniqueID: (NSString *)  uniqueID
timeout: (NSTimeInterval)  timeout
completion: (void(^)(GCKDevice *))  completion 

ממתין לזיהוי מכשיר עם המזהה הייחודי הנתון, ומפעיל חסימת השלמה.

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

Parameters
uniqueIDThe unique ID of the device.
timeoutThe maximum amount of time to wait for the device to be discovered.
completionThe 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

פרטי הנכס

- (GCKDiscoveryState) discoveryState
readnonatomicassign

מצב הגילוי הנוכחי.

- (BOOL) hasDiscoveredDevices
readnonatomicassign

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

- (BOOL) passiveScan
readwritenonatomicassign

סימון שמציין אם הגילוי צריך להשתמש בסריקה "פסיבית".

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

- (BOOL) discoveryActive
readnonatomicassign

סימון שמציין אם הגילוי פעיל או לא.

מאז
3.4
- (NSUInteger) deviceCount
readnonatomicassign

מספר המכשירים שנמצאו כרגע.