總覽
這個虛擬通訊管道：用於在投放傳送端和投放接收端之間交換訊息。
每個管道都標有專屬的命名空間，因此傳送者和接收者之間的單一網路連線可能會有多個頻道可經由多個連線進行。
頻道必須先以 GCKCastSession 註冊才能使用。相關聯的工作階段建立後，系統就會自動連結頻道，然後傳送與接收訊息。
子類別應實作 didReceiveTextMessage: (GCKCastChannel) 方法來處理傳入訊息，且通常會提供其他方法，用於傳送特定命名空間專屬的訊息。
繼承 NSObject。
由 GCKGameManagerChannel、GCKGenericChannel 和 GCKMediaControlChannel 繼承。
執行個體方法摘要 | |
| (instancetype) | - initWithNamespace: |
| 指定初始化器。更多... | |
| (instancetype) | - init |
| 無法使用預設初始化器。更多... | |
| (void) | - didReceiveTextMessage: |
| 在此頻道收到簡訊時呼叫。更多... | |
| (BOOL) | - sendTextMessage: |
| 在這個頻道中傳送簡訊。更多... | |
| (BOOL) | - sendTextMessage:error: |
| 在這個頻道中傳送簡訊。更多... | |
| (NSInteger) | - generateRequestID |
| 為新訊息產生要求 ID。更多... | |
| (NSNumber *__nullable) | - generateRequestNumber |
| 便利方法會將 generateRequestID 的結果納入 NSNumber。更多... | |
| (void) | - didConnect |
| 在此頻道連線時呼叫，表示可透過此頻道的投放裝置交換訊息。更多... | |
| (void) | - didDisconnect |
| 當這個頻道中斷連線時，表示無法再透過這個頻道與投放裝置交換訊息。更多... | |
資源摘要 | |
| NSString * | protocolNamespace |
| 頻道的命名空間。更多... | |
| BOOL | isConnected |
| 此標記會指出頻道目前是否已連線。更多... | |
| GCKDeviceManager * | deviceManager |
| 註冊此管道的裝置管理員 (如果有的話)。更多... | |
方法詳細資料
| - (instancetype) initWithNamespace: | (NSString *) | protocolNamespace |
指定初始化器。
使用指定命名空間建構新的 GCKCastChannel。
- Parameters
-
protocolNamespace The namespace.
在 GCKGenericChannel 中實作。
| - (instancetype) init |
無法使用預設初始化器。
| - (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 |
為新訊息產生要求 ID。
- 傳回
- 系統會產生的 ID；如果頻道目前未連結，則系統會產生 kGCKInvalidRequestID。
| - (NSNumber * __nullable) generateRequestNumber |
便利方法會將 generateRequestID 的結果納入 NSNumber。
- 傳回
- 系統會產生的 ID；如果頻道目前未連結，則系統會產生
nil。
| - (void) didConnect |
在此頻道連線時呼叫，表示可透過此頻道的投放裝置交換訊息。
預設導入方式為免人工管理。
| - (void) didDisconnect |
當這個頻道中斷連線時，表示無法再透過這個頻道與投放裝置交換訊息。
預設導入方式為免人工管理。
資源詳情
|
readnonatomiccopy |
頻道的命名空間。
|
readnonatomicassign |
此標記會指出頻道目前是否已連線。
|
readnonatomicweak |
註冊此管道的裝置管理員 (如果有的話)。
- Deprecated:
- 如果此管道並未註冊已淘汰的 GCKDeviceManager 類別，則將為
nil。