סקירה כללית
מחלקה בסיסית מופשטת לביצוע גילוי מכשירים ובניית סשנים.
אפשר להוסיף תמיכה בסוגים נוספים של מכשירים על ידי הרחבת המחלקה הזו. אפשר לעיין בקטגוריה GCKDeviceProvider(Protected) כדי לראות רשימה של שיטות עזר שמיועדות לשימוש על ידי מחלקות משנה. ספקי מכשירים חדשים נרשמים ב-framework באמצעות 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: |
| שיטת Factory ליצירת מופעים חדשים של 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: | (NSString *__nullable) | sessionID | |
הפונקציה יוצרת סשן חדש למכשיר הנתון, ואפשר גם לציין מזהה של סשן קיים.
צריך להגדיר אותו מחדש במחלקות משנה.
- Parameters
-
device The device to connect to. sessionID The ID of the session to resume; or nilto 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 | |
שיטת Factory ליצירת מופעים חדשים של 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.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).
פרטי הנכס
|
readnonatomiccopy |
מחרוזת שמזהה באופן ייחודי את סוג המכשיר שספק השירות הזה יאתר.
|
readwritenonatomicassign |
האם הסריקה צריכה להיות סריקה פסיבית.
סריקה פסיבית שולחת שאילתות לגילוי בתדירות נמוכה יותר, ולכן היא יעילה יותר, אבל התוצאות לא יהיו עדכניות. סריקה פסיבית מתאימה כשמשתמש לא בוחר באופן פעיל יעד להפעלה ב-Cast. לא כל ההטמעות יכבדו את המאפיין הזה.
|
readnonatomiccopy |
מערך המכשירים שזוהו.