检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
加入房间失败。 HRTC_ERR_CODE_JOIN_ROOM_STATUS_BUSY 90000019 加入房间失败 用户已经在房间里，或正在进行网络探测。 HRTC_ERR_CODE_JOIN_ROOM_SERVER_ERROR 90000020 加入房间失败 加入房间失败，服务器异常。
onRemoteMicrophoneStateChanged：远端麦克风设备状态变更通知 onUserNetworkQualityNotify：加入房间后的用户级网络质量状态回调 新增以下数据类型： HWRtcRemoteMicState：麦克风设备状态 HRTCMultiRoomMediaRelayConfiguration：跨房配置
操作事件详情 表1 用户操作事件说明 事件ID 事件类型 1 加入房间 2 离开房间 3 视频选看/批量选看 5 静音/取消静音 6 切换网络 7 开启/关闭摄像头 9 切换设备 10 DNS查询、TCP/TLS建链、首帧显示起止时间 11 切换角色 12 开始发送媒体流 13 媒体出流成功
启动单流任务 功能介绍 调用此接口接口启动单流任务。 API触发单流录制流名规则：{jobtype}_{jobid}_{roomid}_{userid} jobtype取值为's'代表单流录制。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Exp
见HWRtcStreamType。 disableAdjustRes：下行流码率自适应，默认关闭。YES表示关闭，NO表示开启。若关闭，在网络环境较差情况下可能会有卡顿现象。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。 该接口
播放音效文件并启动混音，需要在有joiner加入房间后调用。 【请求参数】 soundId：音效ID，取值>= 0。 filePath：音效文件路径，支持本地文件和网络文件。 loop：音效文件播放次数，0为循环播放。 pitch：音调大小，（当前不支持）。 pan：空间位置，（当前不支持）。 gain：音量大小，取值范围0-100。
ts/Resource文件夹（如果Documents目录下没有Resource文件夹，则需要创建），需要用户权限来安装驱动，安装完成后需要重启应用。安装成功后，之后打开共享功能无需再安装。 SDK无法检测到应用的卸载动作，所以需要应用层面在卸载时删除驱动缓存，执行如下脚本： sudo
于给其他参与人传输您的视频画面 麦克风权限 使用麦克风 当您使用通话功能时，您可以选择开启该权限，用于给其他参与人传输您的语音 联网 访问网络 当您使用通话功能时，用于完成通话音视频文件的传输 三、对未成年人的保护 在您开始使用本服务时，须承诺您是成年人。若您是未成年人，须您的父
streamType：视频分辨率，具体请参见HRTCStreamType。 disableAdjustRes：禁用分辨率自适应，默认值为false，开启分辨率自适应。若关闭，在网络环境较差情况下可能会有卡顿现象。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。 该接口为
Grs国家/地区码对照表 DR1：中国区 国家/地区名（中文全称） 国家/地区名（英文全称） 国家/地区码（英文缩写） 中国 China CN DR2：亚非拉（新加坡） 国家/地区名（中文全称） 国家/地区名（英文全称） 国家/地区码（英文缩写） 阿联酋 The United Arab
查询用户通话指标 功能介绍 查询用户通话质量指标数据。 可查询5天内的数据，mid 不为null，查询实时数据时，查询起止时间不超过24个小时，每次查询单个用户时，支持跨天查询。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自
iOS 前提条件 已提交工单获取SDK包。 环境要求 准备XCODE集成开发。 准备iOS 8.0及以上的iPhone真机。 支持的终端CPU架构：arm64，arm32。 SDK集成 解压iOS SDK包。 将iOS SDK包中的HWRTCEngine动态库和RTC.bundle文件导入创建的XCODE工程中。
iOS开发前准备 前提条件 已提交工单获取SDK包。 环境要求 准备XCODE集成开发。 准备iOS 8.0及以上的iPhone真机。 支持的终端CPU架构：arm64，arm32。 SDK集成 解压iOS SDK包。 将iOS SDK包中的HWRTCEngine动态库和RTC.
屏幕分享 功能描述 屏幕共享用于在音视频会议中，把一个与会者的屏幕内容，以视频的方式分享给其他与会者。屏幕共享可以共享整个桌面，也可以共享某一个程序窗口。 接口调用流程 实现屏幕共享 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 创建并播放共享流 入会后调用isSc
本地流对象（LocalStream） 该对象继承自Stream对象，并有如下新增接口。 表1 LocalStream接口 接口 描述 initialize 本地流初始化。 setAudioProfile 设置音频流配置。 setVideoProfile 设置视频流配置。 setScreenProfile
使用限制 在使用实时音视频前，您需要了解本服务的使用限制。 表1 使用限制 限制项 说明 应用创建 若首次使用SparkRTC，则需提交工单联系华为云技术客服进行咨询。 直播间人数 一个直播间最多支持500人同时通话。 Android SDK 系统版本：支持Android 5.0及以上版本。
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 RTC.00001001 OperationUnauthorized: get DomainID fail please check X-Auth-Token
常见问题 调用加入房间接口成功后，再调用pushExternalVideoFrame返回90000001 SDK内部系统错误 需要收到加入房间成功回调通知后，才能调用pushExternalVideoFrame。 joiner和player都加入房间成功，joiner调用push
屏幕分享 功能描述 屏幕共享用于在音视频会议中，把一个与会者的屏幕内容，以视频的方式分享给其他与会者。 接口调用流程 实现屏幕共享 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 共享桌面 加入房间后可以调用setAuxiliaryVideoEncoderConfig
状态码 调用实时音视频API时，可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 204 No Content 请求完全成功，同时HTTP响应不包含响应体。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
