סקירה כללית
ערוץ תקשורת וירטואלי להחלפת הודעות בין שולח העברה לבין מקבל Cast.
כל ערוץ מתויג עם מרחב שמות ייחודי, כך שערוצים מרובים יכולים להתפצל על גבי חיבור אחד לרשת בין השולח למקבל.
כדי להשתמש בערוץ, עליך להיות רשום ב-GCKCastSession. לאחר יצירת הסשן המשויך, הערוץ יחובר באופן אוטומטי ויוכל לשלוח ולקבל הודעות.
מחלקות משנה צריכות להטמיע את השיטה didReceiveTextMessage: (GCKCastChannel) כדי לעבד הודעות נכנסות, ובדרך כלל יספקו שיטות נוספות לשליחת הודעות שספציפיות למרחב שמות נתון.
יורש את NSObject.
הועברה בירושה על ידי GCKGameManagerChannel, GCKGenericChannel ו-GCKMediaControlChannel.
סיכום שיטות של מכונה | |
(instancetype) | - initWithNamespace: |
מאתחל ייעודי. עוד... | |
(instancetype) | - init |
מאתחל ברירת המחדל לא זמין. עוד... | |
(void) | - didReceiveTextMessage: |
שיחה כאשר התקבלה הודעת טקסט בערוץ הזה. עוד... | |
(BOOL) | - sendTextMessage: |
שליחת הודעת טקסט בערוץ הזה. עוד... | |
(BOOL) | - sendTextMessage:error: |
שליחת הודעת טקסט בערוץ הזה. עוד... | |
(NSInteger) | - generateRequestID |
יוצר מזהה בקשה להודעה חדשה. עוד... | |
(NSNumber *__nullable) | - generateRequestNumber |
שיטת נוחות שממירה את התוצאה של generateRequestID ל-NSNumber. עוד... | |
(void) | - didConnect |
היא תתקבל כשהערוץ הזה חובר, כדי לציין שעכשיו ניתן להעביר הודעות עם מכשיר ה-CAST בערוץ הזה. עוד... | |
(void) | - didDisconnect |
שיחה שהתקבלה לאחר ניתוק הערוץ, כדי לציין שלא ניתן יותר להעביר הודעות עם מכשיר ה-CAST בערוץ הזה. עוד... | |
סיכום הנכס | |
NSString * | protocolNamespace |
מרחב השמות של הערוץ. עוד... | |
BOOL | isConnected |
סימון שמציין אם הערוץ הזה מחובר כרגע. עוד... | |
GCKDeviceManager * | deviceManager |
מנהל המכשיר שבו הערוץ רשום, אם יש כזה. עוד... | |
פרטי השיטה
- (instancetype) initWithNamespace: | (NSString *) | protocolNamespace |
מאתחל ייעודי.
הפונקציה יוצרת GCKCastChannel חדש עם מרחב השמות הנתון.
- Parameters
-
protocolNamespace The namespace.
הטמעה בGCKGenericChannel.
- (instancetype) init |
מאתחל ברירת המחדל לא זמין.
מיושם ב-GCKMediaControlChannel וב-GCKGameManagerChannel.
- (void) didReceiveTextMessage: | (NSString *) | message |
שיחה כאשר התקבלה הודעת טקסט בערוץ הזה.
הטמעת ברירת המחדל היא 'ללא תפעול'.
- Parameters
-
message The message.
- (BOOL) sendTextMessage: | (NSString *) | message |
שליחת הודעת טקסט בערוץ הזה.
- Parameters
-
message The message.
- החזרות
YES
בהצלחה, אוNO
אם ההודעה לא נשלחה (בגלל שהערוץ לא מחובר או כי מאגר השליחה מלא מדי כרגע).
- Deprecated:
- יש להשתמש בקובץ sendTextMessage:error: שמספק מידע מפורט על השגיאות.
- (BOOL) sendTextMessage: | (NSString *) | message | |
error: | (GCKError *__nullable *__nullable) | error | |
שליחת הודעת טקסט בערוץ הזה.
- Parameters
-
message The message. error A pointer at which to store the error result. May be nil
.
- החזרות
YES
בהצלחה אוNO
אם לא ניתן לשלוח את ההודעה.
- (NSInteger) generateRequestID |
יוצר מזהה בקשה להודעה חדשה.
- החזרות
- המזהה שנוצר, או kGCKInvalidRequestID אם הערוץ לא מחובר כרגע.
- (NSNumber * __nullable) generateRequestNumber |
שיטת נוחות שממירה את התוצאה של generateRequestID ל-NSNumber.
- החזרות
- המזהה שנוצר, או
nil
אם הערוץ לא מחובר כרגע.
- (void) didConnect |
היא תתקבל כשהערוץ הזה חובר, כדי לציין שעכשיו ניתן להעביר הודעות עם מכשיר ה-CAST בערוץ הזה.
הטמעת ברירת המחדל היא 'ללא תפעול'.
- (void) didDisconnect |
שיחה שהתקבלה לאחר ניתוק הערוץ, כדי לציין שלא ניתן יותר להעביר הודעות עם מכשיר ה-CAST בערוץ הזה.
הטמעת ברירת המחדל היא 'ללא תפעול'.
פרטי הנכס
|
readnonatomiccopy |
מרחב השמות של הערוץ.
|
readnonatomicassign |
סימון שמציין אם הערוץ הזה מחובר כרגע.
|
readnonatomicweak |
מנהל המכשיר שבו הערוץ רשום, אם יש כזה.
- Deprecated:
- אם הערוץ הזה לא רשום בקורס GCKDeviceManager שהוצא משימוש, הערך הזה יהיה
nil
.