房间功能
joinRoom
public abstract int joinRoom(HRTCJoinParam joinParam);
【功能说明】
加入房间。
【请求参数】
joinParam:入会参数,具体请参见HRTCJoinParam。
- 0:成功。
- 1:失败。
- 2:上下文为空。
【注意事项】
- onConnectionStateChangedNotify:连接状态发送改变。
- onJoinRoomSuccess:加入房间成功时回调。
- onJoinRoomFailure: 加入房间失败时回调。
- onRemoteUserOnline:加入房间成功后,通知房间内已加入用户的回调,不包括自己。
leaveRoom
public abstract int leaveRoom()
【功能说明】
离开房间。
【请求参数】
无
- 0:成功。
- >0:失败。具体请参见客户端错误码。
- onLeaveRoom:离开房间回调。
- onConnectionStateChangedNotify:连接状态改变回调。
renewAuthorization
public abstract int renewAuthorization(String signature, long ctime);
【功能说明】
鉴权签名过期,收到onAuthorizationExpired回调后更新鉴权签名。
【请求参数】
- signature:鉴权签名字符串。
- ctime:过期时间,单位:秒。
【返回参数】
- 0:成功。
- > 0:失败。具体请参见客户端错误码。
getRoomId
public abstract String getRoomId();
【功能说明】
获取当前房间的roomId。
【请求参数】
无
【返回参数】
String roomId:当前房间的roomId。
changeUserRole
public abstract int changeUserRole(HRTCRoleType role, String authorization, long ctime);
【功能说明】
设置本端用户在房间内的角色。
【请求参数】
- role:用户角色,具体请参见HRTCRoleType。
- authorization:预留参数,填null。
- ctime:预留参数,填0。
- 0:成功。
- >0:失败。具体请参见客户端错误码。
- 切换成功将触发onUserRoleChangedNotify回调。
- 切换失败将触发onError回调,返回错误码“HRTC_ERR_CODE_USER_ROLE_CHANGE_FAIL”。
changeUserName
public abstract int changeUserName(String usrName);
【功能说明】
修改用户昵称。
【请求参数】
usrName:用户新的昵称。昵称不为空,且最大不超过256。
- 0:成功。
- >0:失败。具体请参见客户端错误码。
修改成功后,本端会回调onUserNameChangedNotify事件,远端会回调onRemoteUserNameChangedNotify事件。