检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
功能描述 加入房间后，SDK上报通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。 接口调用流程 通话质量上报 network-quality网络上下行质量报告事件，用户加入房间后，在网络质量变化的时候会触发一次该事件，报告用户的本地网络上下行质量情况。 示例代码如下：
房做准备。 通过此接口创建一个与房间关联的HRTCConnection连接对象。 该方法支持多次调用，创建多个HRTCConnection连接对象，调用每个对象中的joinRoom方法，可以同时加入到多个房间。在每个房间中，可以分别订阅和选看房间中的用户。 具体请参见事件回调(I
克风访问方法。 原因2：由于浏览器的策略，仅允许通过https://方式或者localhost的方式访问用户的摄像头和麦克风权限。 原因3：检查摄像头等设备是否被其他应用占用了。 如果之前访问过使用Web SDK开发的App网站，又清理了该网站的权限，存在一定几率无法开启摄像头和麦克风。
具体说明如表2所示，各计费项的价格详情请参见产品价格详情。 您可以通过华为云实时音视频服务提供的价格计算器，选择您需要的产品规格快速计算出购买实时音视频时长的参考价格。 表2 计费项说明 分类 计费项 场景说明 计费说明 付费方式 基础服务 语音通话 两人或多人语音通话，如语聊房、语音互动直播、语音会议等场景。
【请求参数】 userName：变更的昵称。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。 该接口仅支持房间内调用，更改的昵称会被实时同步到房间内其他用户的用户列表，退出房间不会保存，再次加入房间变更为加入房间时设置的昵称（参考joinRoom接口注意事项）。
客户端错误码 本章节介绍了iOS/macOS SDK的客户端错误码HWRtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因 HWRtcErrorCodeSuccess 0 调用成功 - HWRtcErrorCodeSdkInternalError
API概览 华为云实时音视频服务对应的接口列表如下所示，在调用媒体处理API前，您需要先获取用户Token，Token可以用于调用其他API时鉴权，具体如何调用媒体处理API请参考应用示例。 应用管理接口 表1 应用管理接口 接口 说明 POST /v2/apps 创建应用 GET
0+版本不涉及）的用户，请尽快升级至1.10.0+版本，否则在Chrome 96+浏览器上有可能出现无法使用的情况。 Web SDK 2.0+版本是目前的主力构建版本，承载新功能及体验优化，建议您优先集成使用。Web SDK 1.0+版本仅做存量用户的维护，不再构建新的功能。 Web
startRemoteStreamView的调用是需要放在主线程，不能在onUserJoined调用，否则会返回90000008错误码。 1080p经过RTC传输后，被自动缩放且颜色改变 老版本SDK不支持1080p。 推流1080p，接收到的是360p的流 关闭发送端设置发流编码参数分辨率自适应，关闭收端分辨率自适应。
应用名称 应用的名称。可由字母、数字和“-”、“_”组成，长度不能超过64个字符。 应用类型 应用的类型。 包含如下选项： 教育 文娱 金融 其他 专属场景A 专属场景B 专属场景C 须知： 专属场景为特殊场景，不建议勾选，否则当前应用无法正常使用。 单击“创建”，完成应用的创建。 应
onRemoteMicrophoneStateChanged：麦克风设备状态变更通知 onUserNetworkQualityNotify：加入房间后的网络质量状态回调 新增以下数据类型： HWRtcRemoteMicState：麦克风设备状态 HRTCMultiRoomMediaRelayConfiguration：跨房配置
掉水印）。 xOffset：水印显示的左上角X轴偏移，取(0,1)的浮点数。 yOffset：水印显示的左上角y轴偏移，取(0,1)的浮点数。 fWidthRatio：水印显示的宽度占画面宽度的比例（水印按该参数等比例缩放显示），取(0,1)的浮点数。 【返回参数】 0：方法调用成功。
renewAuthorization 签名更新 √ √ √ √ changeUserRole 设置用户的角色，切换角色时使用 √ √ √ √ changeUserName 设置用户自己的昵称 √ √ √ √ createConnection 创建连接。跨房前需先创建连接 √ √ √ √
动态调整每个画面的大小和位置，最多支持25个画面。不同人数的实际布局效果如下图所示： 如果实际视频流的宽高比与视窗的宽高比不一致，则视频画面会裁剪以适配视窗的大小。 如果中途有流退出房间，则该条流的画面会被后进入房间的流顶替。 如果房间内的人数不足，则剩余位置显示背景色。 如果用户只发送音频，仍然会占用画面位置。
多辅流场景，一个用户同时只能订阅一条辅流；当前正在订阅用户A的辅流，需要订阅另一个用户B的辅流时，需要先停止订阅用户A的辅流，再订阅用户B的辅流。 stopRemoteAuxiliaryStreamView - (int)stopRemoteAuxiliaryStreamView:(NSString *)userid;
ing-stopped。 2020-12-25 第三次正式发布 本次变更如下： 增加本地流LocalStream的混音相关接口。 增加客户端事件ClientEvent的设备列表变更相关事件。 优化部分文档描述。 2020-11-26 第二次正式发布 本次变更如下： 新增TypeScript版本限制。
账号下已存在此应用名的app，修改app_name创建新的应用 400 RTC.00001021 NoPermission: policy doesn't allow action to be performed 没有权限调用此API 请检查生成鉴权信息的账号是否配置了访问此API的权限 400
RECORD_NEW_FILE_START：表示开始创建新的录制文件。以下情况会触发该事件： 录制开始，开始创建第一个录制文件。 断流恢复后，若“最大断流合并时长”配置为“断流后生成新文件”，则开始创建新的录制文件。 当前录制时长超过了配置的录制周期，则开始新的录制文件生成。 RECORD_FILE
情。DeviceChangedInfo定义参考camera-changed中的说明。 麦克风采集设备，拔插后需要应用层进行相应的处理，如：拔除麦克风的时候是否切换其他麦克风采集设备重新采集；插入麦克风的时候是否使用新插入设备进行重新采集。 playback-device-changed
上报当前最活跃的用户userId。该回调主要用于0号会场场景（额外订阅uid为0的用户音频）。 【回调参数】 userId：返回当前远端音量最活跃的用户ID。 noStream：该用户是否有视频流。 0号会场模式下，SDK会持续监测（根据一定时间内用户音量大小）当前最活跃的用户，如果
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
