GCKCastChannel 类

GCKCastChannel 类参考

概览

用于在 Cast 发送器和 Cast 接收器之间交换消息的虚拟通信通道。

每个通道都使用唯一的命名空间进行标记,因此发送方和接收方之间可通过单个网络连接多路复用。

频道必须先向 GCKCastSession 注册,然后才能使用。关联会话建立后,频道将自动连接,然后便可收发消息。

子类应实现 didReceiveTextMessage: (GCKCastChannel) 方法以处理传入消息,并且通常会提供其他方法来发送特定于给定命名空间的消息。

此类继承 NSObject。

GCKGameManagerChannelGCKGenericChannelGCKMediaControlChannel 继承。

实例方法摘要

(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
 指示此频道当前是否已连接的标志。更多...
 
GCKDeviceManagerdeviceManager
 用于注册此渠道的设备管理器(如果有)。更多...
 

方法详细信息

- (instancetype) initWithNamespace: (NSString *)  protocolNamespace

指定的初始化程序。

使用给定命名空间构造新的 GCKCastChannel

Parameters
protocolNamespaceThe namespace.

GCKGenericChannel 中实现。

- (instancetype) init

默认初始化程序不可用。

GCKMediaControlChannelGCKGameManagerChannel 中实现。

- (void) didReceiveTextMessage: (NSString *)  message

在此频道上收到短信时调用。

默认实现为空操作。

Parameters
messageThe message.
- (BOOL) sendTextMessage: (NSString *)  message

在此频道上发送短信。

Parameters
messageThe message.
返回
YES(如果成功发送)或 NO(如果消息无法发送(因为通道未连接或当前发送缓冲区过满)。
Deprecated:
使用 sendTextMessage:error:,它可以提供详细的错误信息。
- (BOOL) sendTextMessage: (NSString *)  message
error: (GCKError *__nullable *__nullable)  error 

在此频道上发送短信。

Parameters
messageThe message.
errorA 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

在此渠道断开连接时调用,表示无法再通过此渠道与投放设备互发消息。

默认实现为空操作。

房源详情

- (NSString*) protocolNamespace
readnonatomiccopy

频道的命名空间。

- (BOOL) isConnected
readnonatomicassign

指示此频道当前是否已连接的标志。

- (GCKDeviceManager*) deviceManager
readnonatomicweak

用于注册此渠道的设备管理器(如果有)。

Deprecated:
如果此频道并非向已废弃的 GCKDeviceManager 类注册,此属性将为 nil