检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本章节介绍了全平台C++ SDK的IHRTCEngine接口详情。 IHRTCEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、屏幕共享、音频管理、音效文件播放管理、自采集自渲染、其他接口。 单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。 父主题：
准备Android运行环境：API 21、Android 5.0以上设备。 支持的终端CPU架构：armeabi-v7a、arm64-v8a。 手机的CPU架构可通过以下方式查询。 手机开启USB调试，连接上电脑，然后打开Windows操作系统中的cmd程序，输入如下命令： adb shell getprop
准备Android运行环境：API 21、Android 5.0以上设备。 支持的终端CPU架构：armeabi-v7a、arm64-v8a。 手机的CPU架构可通过以下方式查询。 手机开启USB调试，连接上电脑，然后打开Windows操作系统中的cmd程序，输入如下命令： adb shell getprop
0：方法调用失败。具体请参见HWRtcErrorCode。 该接口仅支持房间内调用，更改的昵称会被实时同步到房间内其他用户的用户列表，退出房间不会保存，再次加入房间变更为加入房间时设置的昵称（参考joinRoom接口注意事项）。 会触发用户名变更通知的回调onUserNameChangedNotify。 getRoomId
编辑应用：启用、停用或删除应用，生成临时Token。 查询通话质量信息：查询各房间的音视频通话质量等数据详情。 查询通话用量统计：查询近90天的音视频互动时长。 配置录制：创建录制规则，将实时音视频互动内容进行录制并将录制的内容存储到OBS桶中。 编辑应用 您可以对应用进行启用、停用和删除操作，还支持生成临时Token。
用时序图展示各端接口使用顺序，单击相应接口可以快速查看相关接口使用方法。 技巧2：接口总览说明 包括SparkRTC接口总体功能流程图和接口列表，根据功能分类可以快速查找具体功能单个接口，方便接口对接。 技巧3：单个接口使用须知 接口使用时注意使用的时机、参数说明。“注意”是强调每个接口使用的注意事项并带有调用该接口的相关回调，对接时需要仔细阅读。
支持用户上报各自与近端SFU间的上下行网络质量，基于用户级，使本地用户能获取同房间内远端用户与其近端SFU间的网络质量。CMD广播时为房间级，将广播给订阅了此主播流的用户或者此主播被选为TOPN用户且观众订阅了该TOPN用户。 【回调参数】 roomId：用户所在房间号。 userId: 上报的用户id，0为本地，非0为远端。
更新录制规则 功能介绍 调用此接口更新录制规则。 接口约束 如果规则修改后，修改后的规则对正在录制的流无效。 修改后对新的流有效，生效时间为5分钟，即修改规则5分钟后的录制任务会使用新规则进行录制。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API E
设置音效播放的最大音量 getAudioClipsVolume 获取音效播放的最大音量 setVolumeOfAudioClip 设置指定音效的播放音量 getVolumeOfAudioClip 获取指定音效的播放音量 setAudioClipPosition 设置指定音效文件的播放位置
基本使用逻辑 创建新的项目工程，导入SDK后，需要先创建引擎。 您可以在入会前进行视频编码、声音播放模式等参数的配置。 设置本地视图。 用户加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以为其设置远端视图。 在会中，也可以进行切换摄像头等参数的配置。 离开房间后，需销毁对应资源。
基本使用逻辑 创建新的项目工程，导入SDK后，需要先创建引擎。 您可以在入会前进行视频编码、声音播放模式等参数的配置。 设置本地视图。 加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以为其设置远端视图。 在会中，也可以进行切换摄像头等参数的配置。 离开房间后，需销毁对应资源。
为什么入会的时候没有声音？ 可能是由于以下原因导致： 入会前没有订阅。 服务端出现问题。 远端没有开启视频流。 父主题： 问题排查
存储录制文件的OBS桶。 目前录制文件仅支持存储到华北-北京四的OBS桶中。 区域 OBS桶所在的区域。 存储-路径 存储录制文件的OBS桶路径。 录制格式 录制文件的格式，支持HLS和MP4文件格式。 HLS规则 m3u8命名规则 录制m3u8文件的存储路径和文件的前缀。 默认命名格式：
SparkRTC通话出现无声、黑屏、卡顿等如何排查？ SparkRTC视镜产品提供端到端链路质量分析和用量质量查看，具体请参见通话调查和数据洞察。 父主题： 问题排查
查询历史质量 功能介绍 查询质量指标过去每天的体验数据，可查询最近31天的数据。当天未结束，无法查询到当天的体验数据。 最大查询跨度31天。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
5s及以上版本的手机支持只打包arm64架构，可以在XCode的Build Setting < Build Active Architecture Only设置为YES，并将Valid Architectures只写arm64，则SparkRTC SDK可压缩一半的体积。 设置编
创建或更新录制规则 功能介绍 调用此接口创建或更新录制规则。 若当前app在请求的location中无录制规则，则会创建新的录制规则 若当前app在请求的location中已有录制规则，则会更新原来的录制规则 接口约束 一个app在一个location最多创建一个录制规则。 调试
OBS桶授权及取消授权 2次/秒 数据统计分析 查询房间列表 查询用户列表 查询实时规模 查询实时规模分布 查询实时质量数据 查询实时网络 查询用量 查询历史规模 查询历史质量 查询用户通话指标 查询详情事件 查询指定项目用户异常体验事件 查询用户异常体验事件 查询异常事件用户分布 30次/分钟 基本概念
setPriorRemoteVideoStreamType 大小流模式，设置所有订阅的远端视频流类型 pullRemoteVideo 设置是否接收对应远端用户的视频流 pullAllRemoteVideo 设置是否接收所有用户的视频流 startRemoteStreamView 设置远端用户渲染视图（发起选看-老接口）
查询实时质量数据 功能介绍 获取实时质量数据的相关指标在某一时间段内每分钟的统计数据。 最大查询跨度1天。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
