renewAuthorization 更新签名
3.4.3.2 初始化等基础接口 setEncryptionsetEncryption
public abstract int setEncryption(HRTCEncryptionConfig encryptionParam);
【功能说明】
设置端到端加密方式。需要在加入房间前设置生效。其中sdk加密模式,需要设置16位 加密秘钥和加密算法,app加密模式需要先设置回调接口。
【请求参数】
encryptionParam:加密配置,具体请参见HRTCEncryptionConfig。
【返回参数】
● 0:成功。
● <0:失败。
release
public abstract void release();
【功能说明】
释放HRTCConnection。在leaveRoom之后调用,可释放房间占用的资源。
【请求参数】
无
【返回参数】
无
3.4.3.3 房间功能 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:失败。具体请参见客户端错误码。
注意
支持joiner,player角色间相互切换。
● 切换成功将触发onUserRoleChangedNotify回调。
● 切换失败将触发onError回调,返回错误码
“HRTC_ERR_CODE_USER_ROLE_CHANGE_FAIL”。
changeUserName
public abstract int changeUserName(String usrName);
【功能说明】
修改用户昵称。
【请求参数】
usrName:用户新的昵称。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。
注意
修改成功后,本端会回调onUserNameChangedNotify事件,远端会回调 onRemoteUserNameChangedNotify事件。
3.4.3.4 音频管理 muteRemoteAudio
public abstract int muteRemoteAudio(String userId, boolean mute);
【功能说明】
设置是否接收对应远端用户的音频流。
【请求参数】
● userId:用户ID。
● mute:true表示取消音频流接收,false表示开启音频流接收,默认为false。
【返回参数】
● 0:成功。
● > 0:失败。具体请参见客户端错误码。
muteAllRemoteAudio
public abstract int muteAllRemoteAudio(boolean mute);
【功能说明】
设置是否接收所有远端用户的音频流。
【请求参数】
mute:true表示取消音频流接收,false表示开启音频流接收。
【返回参数】
● 0:成功。
● > 0:失败。具体请参见客户端错误码。
注意
● 取消所有音频流接收,同时也会取消接收新加入用户的音频流。
● 开启所有音频流接收,同时也会开启接收新加入用户的音频流。
● 默认开启所有音频流接收。
adjustPlaybackVolume
public abstract int adjustPlaybackVolume(String userId, int volume);
【功能说明】
调整单个用户播放音量增益值。
【请求参数】
● userId:用户ID。
● volume:音量值,取值范围为[0,100],默认音量值为10无增益,10以下表示负 增益,10以上表示正增益,此接口不会影响系统音量。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。