סקירה כללית
מחלקת בסיס מופשטת לביצוע גילוי מכשירים ובניית סשנים.
הארכת הכיתה מאפשרת להוסיף תמיכה בסוגי מכשירים נוספים. הקטגוריה GCKDeviceProvider(Protected) כוללת רשימה של שיטות עזר שמיועדות לשימוש של מחלקות משנה. ספקי מכשירים חדשים רשומים ב-framework באמצעות registerDeviceProvider: (GCKCastContext).
- מאז
- 3.0
יורש את NSObject.
סיכום שיטות של מכונה | |
| (instancetype) | - initWithDeviceCategory: |
| מאתחל ייעודי. עוד... | |
| (void) | - startDiscovery |
| התחלה של סריקת גילוי חדשה. עוד... | |
| (void) | - stopDiscovery |
| הפסקה של סריקת הגילוי. עוד... | |
| (GCKSession *) | - createSessionForDevice:sessionID:sessionOptions: |
| בונה סשן חדש למכשיר הנתון, ויש גם מזהה סשן קיים. עוד... | |
| (GCKSession *) | - createSessionForDevice:sessionID: |
| בונה סשן חדש למכשיר הנתון, ויש גם מזהה סשן קיים. עוד... | |
| (void) | - notifyDidStartDiscovery |
| התראה למנהל הגילוי הנאות על כך שהגילוי התחיל. עוד... | |
| (void) | - notifyDidPublishDevice: |
| התראה למנהל הגילוי הנאות על פרסום מכשיר חדש. עוד... | |
| (void) | - notifyDidUnpublishDevice: |
| מודיע למנהל הגילוי על כך שמכשיר שפורסם בעבר בוטל כי הוא לא זמין יותר. עוד... | |
| (void) | - notifyDidUpdateDevice: |
| מודיע למנהל הגילוי על שינוי של אחד או יותר ממאפייני התצוגה של מכשיר שפורסם בעבר (כמו שם ידידותי או סמלים). עוד... | |
| (GCKDevice *) | - createDeviceWithID:ipAddress:servicePort: |
| (GCKDevice *) | - createDeviceWithID:networkAddress:servicePort: |
| שיטת היצרן לבניית מכונות חדשות של GCKDevice. עוד... | |
סיכום הנכס | |
| NSString * | deviceCategory |
| מחרוזת שמזהה באופן ייחודי את סוג המכשיר שהספק הזה יגלה. עוד... | |
| BOOL | passiveScan |
| אם הסריקה צריכה להיות סריקה פסיבית. עוד... | |
| NSArray< GCKDevice * > * | devices |
| מערך המכשירים שנמצאו. עוד... | |
פרטי השיטה
| - (instancetype) initWithDeviceCategory: | (NSString *) | deviceCategory |
מאתחל ייעודי.
הפונקציה יוצרת GCKDeviceProvider חדש למכשירים מהסוג שצוין.
- Parameters
-
deviceCategory A 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: | (nullable NSString *) | sessionID | |
| sessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
בונה סשן חדש למכשיר הנתון, ויש גם מזהה סשן קיים.
מחלקות משנה צריכות לבטל אותן.
- Parameters
-
device The device to connect to. sessionID The ID of the session to resume; or nilto start a new session.sessionOptions The session options, if any; otherwise nil.
- מאז
- 4.0
| - (GCKSession *) createSessionForDevice: | (GCKDevice *) | device | |
| sessionID: | (nullable NSString *) | sessionID | |
בונה סשן חדש למכשיר הנתון, ויש גם מזהה סשן קיים.
- Parameters
-
device The device to connect to. sessionID The ID of the session to resume; or nilto start a new session.
- Deprecated:
- לכיתות משנה צריך לקרוא ל-createSessionForDevice:sessionID:sessionOptions במקום זאת.
| - (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 | |
- Deprecated:
- משתמשים ב-createDeviceWithID:networkAddress:servicePort: לתמיכה ב-IPv4 וב-IPv6
שיטת היצרן לבניית מכונות חדשות של GCKDevice. הפרמטרים תואמים למאפיינים שאינם משתנים של GCKDevice.
- Parameters
-
deviceID The unique ID identifying this device. This value must be unique among all GCKDevice objects that are created by this provider. ipAddress The IP address of the device, in numeric form (for example, @"10.0.0.10"). May not benil. Supports IPv4 only.servicePort The service port on which connections should be made to this device. May be 0 if a service port is not applicable.
סופק לפי קטגוריה GCKDeviceProvider(Protected).
| - (GCKDevice *) createDeviceWithID: | (NSString *) | deviceID | |
| networkAddress: | (GCKNetworkAddress *) | networkAddress | |
| servicePort: | (uint16_t) | servicePort | |
שיטת היצרן לבניית מכונות חדשות של GCKDevice.
הפרמטרים תואמים למאפיינים שאינם משתנים של GCKDevice.
- Parameters
-
deviceID The unique ID identifying this device. This value must be unique among all GCKDevice objects that are created by this provider. networkAddress The IP address of the device, either IPv4 or IPv6 servicePort The service port on which connections should be made to this device. May be 0 if a service port is not applicable.
- מאז
- 4.2
סופק לפי קטגוריה GCKDeviceProvider(Protected).
פרטי הנכס
|
readnonatomiccopy |
מחרוזת שמזהה באופן ייחודי את סוג המכשיר שהספק הזה יגלה.
|
readwritenonatomicassign |
אם הסריקה צריכה להיות סריקה פסיבית.
סריקה פסיבית שולחת שאילתות גילוי בתדירות נמוכה יותר, כך שהיא יעילה יותר, אבל התוצאות לא יהיו עדכניות באותה מידה. כדאי לבצע סריקה פסיבית כשהמשתמש לא בוחר באופן פעיל יעד העברה. לא כל ההטמעות יכבדו את המאפיין הזה.
|
readnonatomiccopy |
מערך המכשירים שנמצאו.