@protocol RTSDelegate <NSObject>
objectivec

RTSDelegate 协议包含了SDK提供的回调方法，SDK通过代理向应用程序上报一些运行时事件

- (void)rtsEngine:(RTS * _Nonnull)engine onConnectionStateChanged:(ByteRTCConnectionState)state;
objectivec

SDK 与信令服务器连接状态改变回调。连接状态改变时触发。

传入参数

- (void)rtsEngine:(RTS * _Nonnull)engine onNetworkTypeChanged:(ByteRTCNetworkType)type;
objectivec

SDK 当前网络连接类型改变回调。当 SDK 的当前网络连接类型发生改变时回调该事件。

传入参数

- (void)rtsEngine:(RTS *_Nonnull)engine onCreateRoomStateChanged:(NSString * _Nonnull)roomId errorCode:(NSInteger)errorCode;
objectivec

创建房间失败回调。

传入参数

- (void)rtsEngine:(RTS * _Nonnull)engine onSysStats:(const ByteRTCSysStats * _Nonnull)stats;
objectivec

周期性（2s）地发出回调，报告当前cpu与memory使用率

传入参数

- (void)rtsEngine:(RTS * _Nonnull)engine onLoginResult:(NSString * _Nonnull)uid errorCode:(ByteRTCLoginErrorCode)errorCode elapsed:(NSInteger)elapsed;
objectivec

登录结果回调

传入参数

注意
调用 login:uid: 后，会收到此回调。

- (void)rtsEngineOnLogout:(RTS * _Nonnull)engine;
objectivec

登出结果回调

传入参数

注意
调用 logout 后，会收到此回调。

- (void)rtsEngine:(RTS * _Nonnull)engine onServerParamsSetResult:(NSInteger)errorCode;
objectivec

设置应用服务器参数的返回结果

传入参数

注意
调用 setServerParams:url: 后，会收到此回调。

- (void)rtsEngine:(RTS * _Nonnull)engine onGetPeerOnlineStatus:(NSString * _Nonnull)peerUserId status:(ByteRTCUserOnlineStatus)status;
objectivec

查询对端或本端用户登录状态的返回结果

传入参数

注意
必须先调用 getPeerOnlineStatus:，才能收到此回调。

- (void)rtsEngine:(RTS * _Nonnull)engine onMessageReceived:(NSString * _Nonnull)uid message:(NSString * _Nonnull)message;
objectivec

收到远端用户调用 sendMessage:message:config: 发来的文本消息时，会收到此回调

传入参数

- (void)rtsEngine:(RTS * _Nonnull)engine onBinaryMessageReceived:(NSString * _Nonnull)uid message:(NSData * _Nonnull)message;
objectivec

收到房间外用户调用 sendBinaryMessage:message:config: 发来的二进制消息时，会收到此回调。

传入参数

- (void)rtsEngine:(RTS * _Nonnull)engine onMessageSendResult:(int64_t)msgid error:(ByteRTCUserMessageSendResult)error;
objectivec

给指定的用户发送消息的回调

传入参数

注意
当调用 sendMessage:message:config: 或 sendBinaryMessage:message:config: 发送消息后，会收到此回调。

- (void)rtsEngine:(RTS * _Nonnull)engine onServerMessageSendResult:(int64_t)msgid error:(ByteRTCUserMessageSendResult)error message:(NSData * _Nonnull)message;
objectivec

给应用服务器发送消息的回调

传入参数

注意
当调用 sendServerMessage: 或 sendServerBinaryMessage: 接口发送消息后，会收到此回调。

@protocol RTSRoomDelegate <NSObject>
objectivec

语音房间事件回调接口

- (void)rtsRoom:(RTSRoom * _Nonnull)rtcRoom onRoomStateChanged:(NSString * _Nonnull)roomId withUid:(nonnull NSString *)uid state:(NSInteger)state extraInfo:(nonnull NSString *)extraInfo;
objectivec

房间状态改变回调，加入房间、离开房间、发生房间相关的警告或错误时会收到此回调。

传入参数

- (void)rtsRoomOnLeaveRoom:(RTSRoom *_Nonnull)rtsRoom;
objectivec

离开房间成功回调。

用户调用 leaveRoom 方法后，SDK 会停止房间内消息的收发，并在释放所有相关资源后，通过此回调通知用户离开房间成功。

传入参数

注意
用户调用 leaveRoom 方法离开房间后，如果立即销毁 RTC 引擎，则将无法收到此回调事件。

- (void)rtsRoom:(RTSRoom * _Nonnull)rtcRoom onUserJoined:(NSString * _Nonnull)uid elapsed:(NSInteger)elapsed;
objectivec

远端用户首次进房，或断网后重新连入房间时，房间内其他用户将收到该事件。

传入参数

- (void)rtsRoom:(RTSRoom * _Nonnull)rtcRoom onUserLeave:(NSString * _Nonnull)uid reason:(ByteRTCUserOfflineReason)reason;
objectivec

远端用户离开房间时，本地用户会收到此事件

传入参数

- (void)rtsRoom:(RTSRoom * _Nonnull)rtcRoom onRoomMessageReceived:(NSString * _Nonnull)uid message:(NSString * _Nonnull)message;
objectivec

收到房间中调用 sendRoomMessage: 发送的广播文本消息时，收到此回调。

传入参数

- (void)rtsRoom:(RTSRoom * _Nonnull)rtcRoom onRoomBinaryMessageReceived:(NSString * _Nonnull)uid message:(NSData * _Nonnull)message;
objectivec

收到房间中调用 sendRoomBinaryMessage: 发送的广播二进制消息时，收到此回调。

传入参数

- (void)rtsRoom:(RTSRoom * _Nonnull)rtcRoom onRoomMessageSendResult:(int64_t)msgid error:(ByteRTCRoomMessageSendResult)error;
objectivec

向房间内所有用户群发文本或二进制消息后，消息发送方会收到该消息发送结果回调。

传入参数

注意

• 你应调用 sendRoomMessage: 向房间内群发文本消息
• 你应调用 sendRoomBinaryMessage: 向房间内群发二进制消息

@protocol ByteRTCEncryptHandler <NSObject>
objectivec

自定义加密接口

- (NSData * _Nonnull) ByteRTCEncryptRawData:(NSData * _Nonnull)rawData;
objectivec

自定义加密。

使用设定的自定义加密方式，对传输前的音视频帧数据进行加密。

传入参数

返回值
加密后的数据

• 非空，表示加密后的数据
• 为空，表示数据被丢弃

注意

• 使用此接口进行自定义加密前，你必须先设置自定义加密方式，参看 setCustomizeEncryptHandler:。
• 使用 ByteRTCDecryptRawData: 对已加密的音视频帧数据进行解密。
• 返回的数据大小应控制在原始数据的 90% ~ 120% 范围以内，不然将被丢弃。

- (NSData * _Nonnull) ByteRTCDecryptRawData:(NSData * _Nonnull)rawData;
objectivec

自定义解密。

对自定义加密后的音视频帧数据进行解密。关于自定义加密，参看 ByteRTCEncryptRawData:。

传入参数

返回值
解密后的数据

• 非空，表示解密后的数据
• 为空，表示丢弃该帧

注意

• 使用此接口进行解密前，你必须先设定解密方式，参看 setCustomizeEncryptHandler:。
• 返回的数据大小应控制在原始数据的 90% ~ 120% 范围以内，不然将被丢弃。