房间功能

joinRoom

public abstract int joinRoom(HRTCJoinParam joinParam);

【功能说明】

加入房间。

【请求参数】

joinParam：入会参数，具体请参见HRTCJoinParam。

该方法将会触发以下回调：

• onConnectionStateChangedNotify：连接状态发送改变。
• onJoinRoomSuccess：加入房间成功时回调。
• onJoinRoomFailure：加入房间失败时回调，失败原因请参见•加入房间失败时，如何解决？。
• onRemoteUserOnline：加入房间成功后，通知房间内已加入用户的回调，不包括自己。

leaveRoom

public abstract int leaveRoom()

【功能说明】

离开房间。

【请求参数】

无

会触发以下回调：

• onLeaveRoom：离开房间回调。
• onConnectionStateChangedNotify：连接状态改变回调。

renewAuthorization

public abstract int renewAuthorization(String signature, long ctime);

【功能说明】

鉴权签名过期，收到onAuthorizationExpired回调后更新鉴权签名。

【请求参数】

• signature：鉴权签名字符串。
• ctime：过期时间，单位：秒。

【返回参数】

• 0：成功。
• > 0：失败。具体请参见客户端错误码。

changeUserRole

public abstract int changeUserRole(HRTCRoleType role, String authorization, long ctime);

【功能说明】

设置本端用户在房间内的角色。

【请求参数】

• role：用户角色，具体请参见HRTCRoleType。
• authorization：预留参数，填null。
• ctime：预留参数，填0。

支持joiner，player角色间相互切换。

• 切换成功将触发onUserRoleChangedNotify回调。
• 切换失败将触发onError回调，返回错误码“HRTC_ERR_CODE_USER_ROLE_CHANGE_FAIL”。

changeUserName

public abstract int changeUserName(String usrName);

【功能说明】

修改用户昵称。

【请求参数】

usrName：用户新的昵称。昵称不为空，且最大不超过256。

修改成功后，本端会回调onUserNameChangedNotify事件，远端会回调onRemoteUserNameChangedNotify事件。

createConnection

public abstract HRTCConnection createConnection(String roomId, IHRTCConnectionEventHandler eventHandler);

【功能说明】

根据房间ID，创建HRTCConnection对象，为跨房做准备。

通过此接口创建一个与房间关联的HRTCConnection连接对象。

该方法支持多次调用，创建多个HRTCConnection连接对象，调用每个对象中的joinRoom方法，可以同时加入到多个房间。在每个房间中，可以分别订阅和选看房间中的用户。

具体请参见事件回调(IHRTCConnectionEventHandler)中相关接口和回调。

【请求参数】

roomId：房间ID。

eventHandler：引擎事件句柄，用于加入房间、离开房间等事件回调，具体请参见事件回调(IHRTCConnectionEventHandler)。

• 同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。
• 如果使用HRTCConnection对象加入房间，则加入房间的房间ID不能和已创建连接对象对应的房间ID相同。
• 同一时间只能以JOINER角色加入某一个房间。

addMultiRoomMediaRelay

virtual int addMultiRoomMediaRelay(HRTCMultiRoomMediaRelayConfiguration roomMediaRelayConfiguration)

【功能说明】

添加单个跨房。发起跨房后由云侧单向将本端上行流推至目标房间，即只推流不收流。

【请求参数】

roomMediaRelayConfiguration：跨房信息，具体请参见HRTCMultiRoomMediaRelayConfiguration。

removeMultiRoomMediaRelay

virtual int removeMultiRoomMediaRelay(HRTCMultiRoomMediaRelayConfiguration roomMediaRelayConfiguration)

【功能说明】

删除单个跨房。

【请求参数】

roomMediaRelayConfiguration：跨房信息，具体请参见HRTCMultiRoomMediaRelayConfiguration。

stopMultiRoomMediaRelay

virtual int stopMultiRoomMediaRelay()

【功能说明】

停止所有跨房。

【请求参数】