概览
用于在 Cast 发送器和 Cast 接收器之间交换消息的虚拟通信通道。
每个通道都使用唯一的命名空间进行标记，因此发送方和接收方之间可通过单个网络连接多路复用。
频道必须先向 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。