<JRTCRoomCallback>协议 参考

#import <JRTCRoomCallback.h>

构造函数
(void)	- onRoomStateChanged:oldState:room:
(void)	- onRoomPropertyChanged:room:
(void)	- onJoin:reason:roomId:room:
(void)	- onLeave:roomId:room:
(void)	- onQuery:result:reason:queryInfo:room:
(void)	- onParticipantJoin:room:
(void)	- onParticipantLeft:reason:room:
(void)	- onParticipantUpdate:changeParam:room:
(void)	- onMessageReceived:content:fromUserId:room:
(void)	- onInviteSipUserResult:result:reason:room:
(void)	- onDeliveryAbort:deliveryUserId:reason:room:
(void)	- onFileAudioInputFinish:
(void)	- onEnableRemoteAdvancedRecordResult:result:error:

详细描述

房间相关事件回调

函数文档

onDeliveryAbort:deliveryUserId:reason:room:

- (void) onDeliveryAbort:		(bool)	isShutDown
deliveryUserId:		(NSString *)	deliveryUserId
reason:		(NSString *)	reason
room:		(JRTCRoom *)	room

录制异常回调

远程录制异常退出时会上报此回调。

参数

isShutDown	录制异常时服务器是否自动结束通话 true: 自动结束通话 false: 不自动结束通话
deliveryUserId	录制异常的用户ID
reason	录制异常的原因
room	当前 JRTCRoom 对象

onEnableRemoteAdvancedRecordResult:result:error:

- (void) onEnableRemoteAdvancedRecordResult:		(JRTCRoom *)	room
result:		(bool)	result
error:		(NSString *)	error

开启远程录制（增强录制）结果回调

参数

room	当前 JRTCRoom 对象
result	开启远程录制是否成功 true: 成功 false: 失败
error	失败错误描述，当 result 为 false 时该值有效。

onFileAudioInputFinish:

- (void) onFileAudioInputFinish:

(JRTCRoom *)

room

本地文件音频源输入完成回调

onInviteSipUserResult:result:reason:room:

- (void) onInviteSipUserResult:		(int)	operationId
result:		(bool)	result
reason:		(ReasonCode)	reason
room:		(JRTCRoom *)	room

邀请Sip用户结果回调

调用 inviteSipUser 接口邀请落地用户时，会收到此回调。

参数

operationId	操作ID，对应 inviteSipUser 接口返回值
result	邀请用户是否成功 true: 成功，此时会触发 onParticipantJoin 回调 false: 失败
reason	失败原因，当 result 为 false 时该值有效。参见：失败原因
room	当前 JRTCRoom 对象

onJoin:reason:roomId:room:

- (void) onJoin:		(bool)	result
reason:		(ReasonCode)	reason
roomId:		(NSString *)	roomId
room:		(JRTCRoom *)	room

加入房间结果回调

调用 join 接口成功后，会收到此回调。

参数

result	加入房间是否成功 true: 成功 false: 失败
reason	加入失败原因，当 result 为 false 时该值有效。失败原因参见：错误码
roomId	房间标识
room	当前 JRTCRoom 对象

onLeave:roomId:room:

- (void) onLeave:		(ReasonCode)	reason
roomId:		(NSString *)	roomId
room:		(JRTCRoom *)	room

离开房间结果回调

调用 leave 接口成功后，会收到此回调。

参数

reason	离开原因，参见：离开原因
roomId	房间标识
room	当前 JRTCRoom 对象

onMessageReceived:content:fromUserId:room:

- (void) onMessageReceived:		(NSString *)	type
content:		(NSString *)	content
fromUserId:		(NSString *)	fromUserId
room:		(JRTCRoom *)	room

接收房间消息的回调

当房间中有成员调用 sendMessage 接口发送消息时，接收消息的成员会收到此回调。

参数

type	消息类型，对应 sendMessage 方法中的 type 参数
content	消息内容，对应 sendMessage 方法中的 content 参数
fromUserId	消息发送成员的用户ID
room	当前 JRTCRoom 对象

onParticipantJoin:room:

- (void) onParticipantJoin:		(JRTCRoomParticipant *)	participant
room:		(JRTCRoom *)	room

新成员加入回调

当有用户调用 join 接口加入房间成功时，已在房间中的成员会收到此回调。

参数

participant	JRTCRoomParticipant 成员对象
room	当前 JRTCRoom 对象

onParticipantLeft:reason:room:

- (void) onParticipantLeft:		(JRTCRoomParticipant *)	participant
reason:		(ReasonCode)	reason
room:		(JRTCRoom *)	room

成员离开回调

当房间中有成员调用 leave 接口离开房间后，房间中的其他成员会收到此回调。

参数

participant	JRTCRoomParticipant 成员对象
reason	离开原因
room	当前 JRTCRoom 对象

onParticipantUpdate:changeParam:room:

- (void) onParticipantUpdate:		(JRTCRoomParticipant *)	participant
changeParam:		(JRTCRoomParticipantChangeParam *)	changeParam
room:		(JRTCRoom *)	room

成员属性更新回调

当房间中有成员的属性发生变化时，房间中的其他成员会收到此回调，例如音频上传状态、视频上传状态、网络状态等发生变化。

参数

participant	JRTCRoomParticipant 成员对象
changeParam	JRTCRoomParticipantChangeParam 更新标识类对象
room	当前 JRTCRoom 对象

onQuery:result:reason:queryInfo:room:

- (void) onQuery:		(int)	operationId
result:		(bool)	result
reason:		(ReasonCode)	reason
queryInfo:		(JRTCRoomQueryInfo *)	queryInfo
room:		(JRTCRoom *)	room

查询房间信息结果回调

调用 query 接口成功后，会收到此回调。

参数

operationId	操作ID，对应 query 接口返回值
result	查询房间信息是否成功 true: 查询成功 false: 查询失败
reason	查询失败原因，当 result 为 false 时该值有效。失败原因参见：错误码
queryInfo	JRTCRoomQueryInfo 对象，查询到的房间信息，当失败时只需关注 roomId
room	当前 JRTCRoom 对象

onRoomPropertyChanged:room:

- (void) onRoomPropertyChanged:		(JRTCRoomPropChangeParam *)	changeParam
room:		(JRTCRoom *)	room

房间属性变化回调

当房间的属性发生变化时，会收到此回调，例如房间中有成员发起屏幕共享、录制状态发生变化等。

参数

changeParam	JRTCRoomPropChangeParam 变化标识集合
room	当前 JRTCRoom 对象

onRoomStateChanged:oldState:room:

- (void) onRoomStateChanged:		(RoomState)	state
oldState:		(RoomState)	oldState
room:		(JRTCRoom *)	room

自身在房间中的状态变化回调

当自身在房间中的状态发生变化时，会收到此回调，例如加入房间、加入房间成功、离开回调等。

状态：

• StateIdle : 空闲状态
• StateJoining : 加入中
• StateJoined : 已加入
• StateLeaving : 离开中

参数

state	当前状态
oldState	变化前状态
room	当前 JRTCRoom 对象