• 沒有找到結果。

初始化等基础接口 setEncryptionsetEncryption

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:失败。具体请参见客户端错误码。