מחלקה של GCKDeviceProvider

הפניית מחלקה של GCKDeviceProvider

סקירה כללית

שיעור בסיס מופשט לביצוע גילוי מכשירים ובניית סשנים.

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

סינסה
3.0

עוברת בירושה את NSObject.

סיכום של שיטת המכונה

(instancetype) - initWithDeviceCategory:
 מאתחל ייעודי. עוד...
 
(void) - startDiscovery
 התחלה של סריקת גילוי חדשה. עוד...
 
(void) - stopDiscovery
 מפסיק את סריקת הגילוי. עוד...
 
(GCKSession *) - createSessionForDevice:sessionID:
 יצירת סשן חדש עבור המכשיר הנתון (אופציונלי) וגם מזהה סשן קיים. עוד...
 
(void) - notifyDidStartDiscovery
 נשלחת למנהל הגילוי הודעה על תחילת הגילוי. עוד...
 
(void) - notifyDidPublishDevice:
 מודיע למנהל הגילוי שמכשיר חדש פורסם. עוד...
 
(void) - notifyDidUnpublishDevice:
 מודיע למנהל הגילוי שמכשיר שפורסם בעבר בוטל כי הוא כבר לא זמין. עוד...
 
(void) - notifyDidUpdateDevice:
 מודיע למנהל הגילוי כי אחד או יותר ממאפייני התצוגה של מכשיר שפורסם בעבר (כמו שם או סמלים ידידותיים) השתנה. עוד...
 
(GCKDevice *) - createDeviceWithID:ipAddress:servicePort:
 שיטה להגדרות של יצירת מכונות חדשות מסוג GCKDevice. עוד...
 

סיכום הנכס

NSString * deviceCategory
 מחרוזת שמזהה באופן ייחודי את סוג המכשיר שהספק הזה יגלה. עוד...
 
BOOL passiveScan
 אם הסריקה צריכה להיות סריקה פסיבית. עוד...
 
NSArray< GCKDevice * > * devices
 מערך המכשירים שזוהו. עוד...
 

פרטי השיטה

- (instancetype) initWithDeviceCategory: (NSString *)  deviceCategory

מאתחל ייעודי.

יוצר GCKDeviceProvider חדש למכשירים מהסוג שצוין.

Parameters
deviceCategoryA string that uniquely identifies the type of device that is managed by by this provider.
- (void) startDiscovery

התחלה של סריקת גילוי חדשה.

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

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

- (void) stopDiscovery

מפסיק את סריקת הגילוי.

חובה לשנות את סיווגי המשנה.

- (GCKSession *) createSessionForDevice: (GCKDevice *)  device
sessionID: (NSString *__nullable)  sessionID 

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

חובה לשנות את סיווגי המשנה.

Parameters
deviceThe device to connect to.
sessionIDThe ID of the session to resume; or nil to start a new session.
- (void) notifyDidStartDiscovery

נשלחת למנהל הגילוי הודעה על תחילת הגילוי.

סופק על ידי קטגוריה GCKDeviceProvider(Protected).

- (void) notifyDidPublishDevice: (GCKDevice *)  device

מודיע למנהל הגילוי שמכשיר חדש פורסם.

סופק על ידי קטגוריה GCKDeviceProvider(Protected).

- (void) notifyDidUnpublishDevice: (GCKDevice *)  device

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

סופק על ידי קטגוריה GCKDeviceProvider(Protected).

- (void) notifyDidUpdateDevice: (GCKDevice *)  device

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

סופק על ידי קטגוריה GCKDeviceProvider(Protected).

- (GCKDevice *) createDeviceWithID: (NSString *)  deviceID
ipAddress: (NSString *)  ipAddress
servicePort: (uint16_t)  servicePort 

שיטה להגדרות של יצירת מכונות חדשות מסוג GCKDevice.

הפרמטרים תואמים למאפיינים שלא ניתנים לשינוי של GCKDevice.

Parameters
deviceIDThe unique ID identifying this device. This value must be unique among all GCKDevice objects that are created by this provider.
ipAddressThe IP address of the device, in numeric form (for example, @"10.0.0.10"). May not be nil.
servicePortThe service port on which connections should be made to this device. May be 0 if a service port is not applicable.

סופק על ידי קטגוריה GCKDeviceProvider(Protected).

פרטי הנכס

- (NSString*) deviceCategory
readnonatomiccopy

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

- (BOOL) passiveScan
readwritenonatomicassign

אם הסריקה צריכה להיות סריקה פסיבית.

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

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

מערך המכשירים שזוהו.