检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询实时质量数据 功能介绍 获取实时质量数据的相关指标在某一时间段内每分钟的统计数据。 最大查询跨度1天。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /
查询房间列表 功能介绍 指定时间范围查询这段期间创建的房间列表。 最大查询跨度90天。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v1/{project_id}/rtc/rooms
Web端如何切换摄像头和麦克风？ 音视频输入设备通过设备ID（deviceId）标识，每个音视频设备均有一个唯一的设备ID，您可以通过getDevices方法获取。设备ID是随机生成的，部分情况下同一个设备的ID可能会改变，因此建议您每次切换设备时都先调用getDevices获取
查询应用列表 功能介绍 调用此接口查询应用列表。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/apps 表1 Query参数 参数 是否必选 参数类型
如何获取密钥？ app_key为华为云SparkRTC针对每个app生成的鉴权密钥，需要安全保存，谨防泄漏。您可以通过以下方式获取： 登录实时音视频控制台。 在左侧导航栏中，选择“应用管理”，进入应用管理页面。 在目标应用行单击应用名称，进入应用详情页面。 “鉴权私钥”可见状态下，复制应用的鉴权私钥。
接入鉴权 为保证SparkRTC的通信安全，当用户加入房间时，华为云SparkRTC服务需要对其进行接入鉴权。本章节主要介绍华为云SparkRTC接入鉴权的实现原理及鉴权签名的生成方法。 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在SDK加入房间时设置
云资源授权 您可以将OBS桶授权给SparkRTC服务，允许录制文件存储在OBS桶中。 注意事项 授权的OBS桶所在区域必须为华北-北京四。 前提条件 因录制生成的视频文件是存储在OBS服务中的，因此，您需要先开通OBS服务，具体请参见OBS快速入门。 已在OBS服务中创建用于存
更新录制规则 功能介绍 调用此接口更新录制规则。 接口约束 如果规则修改后，修改后的规则对正在录制的流无效。 修改后对新的流有效，生效时间为5分钟，即修改规则5分钟后的录制任务会使用新规则进行录制。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API E
常用概念 应用标识 应用标识或应用ID，简称appID，是SparkRTC用来区分不同应用的唯一标识，在SparkRTC控制台中创建应用时自动生成。 房间 房间是一个音视频空间，同一房间内的用户可以互相接收对方的实时音视频数据。 SparkRTC使用房间这个虚拟的概念，用于用户之间的相互隔离。
配置录制规则 SparkRTC服务支持将实时音视频互动内容进行录制并将录制的内容存储到OBS桶中，您可以在OBS服务中对录制的音视频文件进行下载、分享等处理。相关操作流程，如图1所示。 图1 录制流程图 创建桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。
配置录制回调 SparkRTC服务提供了录制任务状态回调设置，支持配置HTTP/HTTPS URL，向用户服务器发送POST请求，将录制任务状态信息实时反馈到用户服务器。 回调协议 请求：HTTP POST请求，请求Body的内容为JSON格式。 应答：HTTP STATUS CODE
创建或更新录制规则 功能介绍 调用此接口创建或更新录制规则。 若当前app在请求的location中无录制规则，则会创建新的录制规则 若当前app在请求的location中已有录制规则，则会更新原来的录制规则 接口约束 一个app在一个location最多创建一个录制规则。 调试
合流录制 场景说明 将房间中的多路音视频进行云端混流，再将混合后的音视频流录制成一个文件。 合流布局 在合流录制模式下，支持分屏九宫格模板和共享屏幕模板（主视窗居左/主视窗居右）两种预设合流布局。同时，也支持用户自定义合流布局样式（自定义视频窗格位置）。 九宫格模板 每个用户画面
Windows 前提条件 已提交工单获取SDK包。 环境要求 准备集成开发环境，建议使用Microsoft Visual Studio 2015或以上版本。 支持Windows 7或以上版本的Windows设备。 支持的平台：x86 release。 资源文件列表 头文件目录 lib文件目录
问题排查 SparkRTC通话出现无声、黑屏、卡顿等如何排查？ 为什么入会的时候没有声音？ 为什么视频会出现卡顿？ 如何处理视频黑屏问题？ 为什么无法打开摄像头？ 什么原因导致跨房不成功？ SparkRTC启动云端录制但没有生成录制文件怎么排查？ 集成SparkRTC加入房间失败是什么原因？
什么是Signature？ 为保证RTC的通信安全，当用户加入频道时，华为云SparkRTC服务需要对其进行接入鉴权。 图1 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应的SDK的初始化或登录函数中提供“app_id”、“room_id”、“use
应用管理 您可以在实时音视频控制台创建应用并查询应用的基本信息，应用创建后，您可以使用应用对应的App ID和域名进入互动频道。 注意事项 首次使用华为云实时音视频服务，请先提交工单联系华为云技术客服进行业务咨询。 停用或删除应用会导致业务不可用，请谨慎处理。 创建应用 登录实时音视频控制台。
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 RTC.00001001 OperationUnauthorized: get DomainID fail please check X-Auth-Token
接收增值（录制）事件回调通知内容 SparkRTC服务回调用户提供的接口时，会附带以下信息。 表1 请求Body参数 参数 是否必选 参数类型 描述 job_id 否 String 任务编号，可以用于修改、查看和停止录制任务 stream_name 否 String 流名 app_id
常见问题 初始化引擎时，countryCode应该如何填写？ countryCode表示区域码，如果对应的是GLOBAL类型，则直接填空字符串，即""，如果是CN类型，则可以填"CN"。具体请参见国家码对照表。 初始化引擎时，domain应该如何填写？ 该字段已废弃，不需要再传值。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
