概览
用于在 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
。