检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
network-quality 【事件说明】 网络上下行质量报告事件，用户加入房间后，SDK在网络质量变化的时候会触发一次该事件，报告用户的本地网络上下行质量情况。 【回调参数】 NetworkQualityEvent：必选， NetworkQualityInfo类型，网络上下行质量详情。 NetworkQualityInfo定义为：{
tcNetworkBandwidth *)bandwidthParam; 【功能说明】 设置网络带宽限制。需要在每次加入房间之前设置。 【请求参数】 bandwidthParam：设置网络带宽限制参数，具体请参见HWRtcNetworkBandwidth。 【返回参数】 0：成功。
数据统计分析 查询房间列表 查询用户列表 查询实时规模 查询实时规模分布 查询实时质量数据 查询实时网络 查询用量 查询历史规模 查询历史质量 查询用户通话指标 查询详情事件接口 查询指定项目用户异常体验事件 查询用户异常体验事件 查询异常事件用户分布
在线教育、语聊房、在线合唱等。 旁路直播 将房间内的音视频流混流转码后推送RTMP的视频流给直播服务。 互动直播、大型会议等。 网络检测 支持通过网络检测接口判断或预测用户当前的网络状况是否良好。 - 自定义视频数据 支持自定义的视频源和渲染器，使用非摄像头的视频源，例如视频文件、外接设备、第三方定制数据源等。
应用关闭鉴权时，加入房间还需要填鉴权参数吗？ 不需要填。 加入房间失败时，如何解决？ 首先通过返回的客户端错误码进行分析，主要有以下几个原因： 网络问题，您需要确认网络是否正常运行。 鉴权问题，应用默认开启鉴权，您需要确保鉴权生成正确，参数合理传入，且保证没过期，需要注意ctime参数的设置，具体可参考接入鉴权。
setNetworkBandwidth(const HRTCNetworkBandwidth &bandwidthParam) 【功能说明】 设置网络带宽限制，在每次加入房间之前调用。 【请求参数】 bandwidthParam：带宽设置参数，具体请参见HRTCNetworkBandwidth。
int setNetworkBandwidth(HRTCNetworkBandwidth bandwidthParam); 【功能说明】 设置网络带宽限制。需要在每次加入房间之前设置。 【请求参数】 bandwidthParam：带宽设置参数，具体请参见HRTCNetWorkBandwidth。
atsNotify回调周期 检测功能 表9 检测功能接口 接口 描述 startNetworkTest 开启会前网络探测 stopNetworkTest 停止会前网络检测 自定义视频采集和渲染 表10 自定义视频采集和渲染接口 接口 描述 setExternalVideoFrameOutputEnable
y; 【功能说明】 会中基于流级别的网络质量检测回调，音频流、视频流分别回调。 【回调参数】 connection：跨房引擎。 upStreamQualityArray：上行网络质量上报。 downStreamQualityArray：下行网络质量上报。 connection:onVideoStatsNotify
设置分辨率时需对照华为SDK系统推荐的码表才能设置成功。 加入房间失败时，如何解决？ 首先通过返回的客户端错误码进行分析，主要有以下几个原因： 网络问题，需确认网络是否正常运行。 鉴权问题，应用默认开启鉴权，您需要确保鉴权生成正确，参数合理传入，且保证没过期，具体可参考接入鉴权。 参数问题，确
getAudioClipDuration 获取音效文件时长 检测功能 表8 检测功能接口 接口 描述 startNetworkTest 会前网络质量开启测试 stopNetworkTest 会前网络质量停止测试 自定义音频采集和渲染 表9 自定义音频采集和渲染接口 接口 描述 setExternalAudioCapture
windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 startNetworkTest 开启会前网络质量测试 √ √ √ √ stopNetworkTest 停止会前网络质量测试 √ √ √ √ setAudioConfig 设置使用场景 √ √ √ √ 父主题： IHRTCEngine
支持用户查看通话用量和质量数据，了解通话用量和质量的总体趋势、不同维度的分布情况和每天的数据明细。 实时数据 支持用户查看音视频通话的规模、体验、网络指标的实时数据和分析图表，实时掌握项目整体动态，及时识别异常通话体验和异常根因。 自动诊断 支持用户实时查看应用下所有通话体验异常的用户信息及异常明细数据。
版本规划 本章节为您介绍实时音视频服务（SparkRTC）客户端SDK的版本支持机制。 版本号说明 版本号格式为a.b.c.d，其中： a为大版本号：在版本架构重构的情况下更新。 b为小版本号：在重大特性或接口变更的情况下更新。 c为月度开发版本号：月度累加。 d为release
单流录制 场景说明 将房间中的每一个用户的音视频流分别录制成独立的文件。 录制机制 SparkRTC提供的单流录制支持自启动模式，即单流自动录制，具体的实现机制如下图所示。 图1 单流录制 图2 单流自动录制 实现流程 创建OBS桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。
release 释放IHRTCConnection对象资源 getRoomId 获取当前连接房间号 setNetworkBandwidth 设置网络带宽限制 房间功能 表2 房间功能接口 接口 描述 joinRoom 加入房间 leaveRoom 离开房间 renewAuthorization
描述 release 释放Connection setEncryption 设置端到端加密模式 setNetworkBandwidth 设置网络带宽限制 表2 房间功能接口 接口 描述 joinRoom 加入房间 leaveRoom 离开房间 getRoomId 获取房间id renewAuthorization
onRemoteMicrophoneStateChanged：麦克风设备状态变更通知 onUserNetworkQualityNotify：加入房间后的网络质量状态回调 新增以下数据类型： HWRtcRemoteMicState：麦克风设备状态 HRTCMultiRoomMediaRelayConfiguration：跨房配置
音效文件播放管理 主要功能包括开始/停止/暂停/恢复播放音频或音效文件、音频/音效音量相关设置。 检测功能 主要功能包括启动/关闭入会前网络检测。 自定义音频采集和渲染 主要功能包括是否开启音频自采集、推送外部音频数据。 自定义视频采集和渲染 主要功能包括是否开启视频自采集、推送外部视频数据、是否开启视频流自渲染。
setVideoFrameObserver 使能视频前后处理 renewAuthorization 鉴权签名过期，更新签名 setNetworkBandwidth 设置网络带宽限制 房间功能 表2 房间功能接口 接口 描述 joinRoom 加入房间 changeUserRole 设置用户的角色，切换角色时使用
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
