检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
课、K歌房、在线课堂等。 高画质 支持720P、1080P的高清画质视频。 视频通话、互动直播、在线课堂等。 角色切换 支持房间内角色切换，观众自由、平滑上下麦，切换过程无需等待。 互动直播、在线课堂等。 单用户加入多房间 支持单个主播加入多个房间互动PK。 秀场直播、PK连麦、超级大班课等。
加入指定房间后才可以在指定房间内进行角色切换，当前仅支持joiner和player角色切换。跨房场景下，通过对应connection连接下的changeUserRole接口实现在跨入房间中的角色类型切换。 切换成功触发onUserRoleChangedNotify回调。切换失败会触发onError
【返回参数】 0：成功。 >0：失败。具体请参见客户端错误码。 支持joiner，player角色间相互切换。 切换成功将触发onUserRoleChangedNotify回调。 切换失败将触发onError回调，返回错误码“HRTC_ERR_CODE_USER_ROLE_CHANGE_FAIL”。
实现音视频通话（Web） 环境准备 屏幕分享 通话质量监测 播放音频文件（混音） 切换音频模式 父主题： 实现音视频通话
费。 实时音视频服务还提供了如下包周期的音视频通话套餐包，目前暂未开放至订购界面。如需订购，请提交工单申请订购。 表1 套餐包 计费项 清晰度 计费套餐 单价（元/年） 包周期 语音通话 - CloudRTC 2.5万分钟音频套餐包 158 1年 CloudRTC 25万分钟音频套餐包
90000016 服务器无响应 服务器无响应。 HWRtcErrorCodeUserRoleChangeFail 90000017 切换角色失败 切换角色失败。 HWRtcErrorCodeJoinRoomFail 90000018 加入房间失败 加入房间失败。 HWRtcErro
互动型角色。 普通观众（player）：只收流的观看型角色。 SparkRTC示例Demo中的角色切换、上台/下台、上麦/下麦主要指在joiner/player两个角色之间进行切换。 主流 主要指摄像头采集的视频流，SparkRTC对同一视频源支持最多同时编码和收发四挡数据类型（
setNetworkBandwidth 设置网络带宽限制 房间功能 表2 房间功能接口 接口 描述 joinRoom 加入房间 changeUserRole 设置用户的角色，切换角色时使用 renewAuthorization 签名更新 leaveRoom 离开房间 changeUserName 设置用户自己的昵称
然后调用startScreenShare开始共享。 还可以调用setAuxiliaryVideoEncodeSmooth来切换屏幕共享的分辨率，从默认的1080p切换为720p。 示例代码如下： //获取引擎 IHRTCEngine* engine = CRtcEngineMgr::
整合后已废弃。 参数变更的接口及回调： changeUserRole：不再需要roomId参数，跨房所在房间用HWRtcConnection连接调用角色切换接口，HWRtcEngine只作其所在房间的角色切换。 2021-01-28 第十次正式发布 本次变更如下： HWRtcEngine新增接口：getVersion
leaveRoom 离开房间 getRoomId 获取房间id renewAuthorization 更新签名 changeUserRole 切换角色 changeUserName 修改用户昵称 表3 视频管理接口 接口 描述 setPriorRemoteVideoStreamType
【返回参数】 0：成功。 >0：失败。具体请参见客户端错误码。 支持joiner，player角色间相互切换。 切换成功将触发onUserRoleChangedNotify回调。 切换失败将触发onError回调，返回错误码“HRTC_ERR_CODE_USER_ROLE_CHANGE_FAIL”。
TopN模式后，本地用户不需要通过调用接口，单独订阅某个远端用户的音频，即可接收到当前房间内音量值最大的三个用户的音频。具体接口调用可参见切换音频模式。 调用setVolume4TopThree设置音频最大三方音量值是设置房间内三个最大声音的用户的音量值吗？传参需要传一个参数还是三个参数？
leaveRoom 离开房间 √ √ √ √ renewAuthorization 签名更新 √ √ √ √ changeUserRole 设置用户的角色，切换角色时使用 √ √ √ √ changeUserName 设置用户自己的昵称 √ √ √ √ createConnection 创建连接。跨房前需先创建连接
connection establish failed, please switch network or try again later 媒体建链失败，请切换网络重试。 RTC_ERR_CODE_CLIENT_RELAY_ROOM_OVER_MAXNUM 90100027 relay room number
主要功能包括是否开启音频自采集、推送外部音频数据。 自定义视频采集和渲染 主要功能包括是否开启视频自采集、推送外部视频数据、是否开启视频流自渲染。 设备管理 主要功能包括切换摄像头、声音播放模式等。 跨房功能 跨房间连麦，指主播的媒体流可以同时转发进多个房间频道，实现主播跨频道与其他主播实时互动的场景。房间中的
为本地流对象添加音视频轨。 removeTrack 从本地流对象移除音视频轨。 replaceTrack 为本地流对象替换音视频轨。 switchDevice 切换媒体输入设备。 startAudioMixing 开始播放在线音频文件。 stopAudioMixing 停止播放在线音频文件。 pauseAudioMixing
Role方法将本端在该房间的角色切换为HWRtcRolePlayer后才能以HWRtcRoleJoiner跨入其他房间。如果本端用户是以HWRtcRolePlayer角色加入此跨房房间，则需要调用跨房连接的setUserRole方法将本端的角色切换为HWRtcRoleJoiner后才能发送音频流和视频流。
Web端SDK可以获取当前音量大小吗？ Web端支持监听远端离开房间吗？ Web端通话过程中为什么会出现回声、杂音、噪声、声音小？ Web端如何切换摄像头和麦克风？ SparkRTC支持白板功能吗？ 相同UserID支持同时进入多个房间吗？ SparkRTC房间的生命周期是多久？ Sp
实现过程 加入房间前调用主引擎的setExternalVideoCapture 加入房间前调用此接口打开视频自采集功能。一旦开启后，将无法切换。 //开启自采集功能 [rtcEngine setExternalVideoCapture:YES]; 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
