检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高。 Token认证:通过Token认证调用请求。
"result" : "success" } 前提条件 已添加应用。 操作步骤 登录实时音视频控制台。 在左侧导航栏中,选择“应用管理”,进入“应用管理”页面。 在需要创建录制回调的应用行,单击“配置”,进入录制配置页面。 在“回调配置”区域,单击“编辑”,配置回调信息,如图1所示。 图1
查询自动录制配置 功能介绍 调用此接口查询自动录制配置 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v2/apps/{app_id}/auto-record-mode
Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息。 表3 请求Body参数
状态码: 500 配置失败,服务器端错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError" } 状态码 状态码 描述 200 配置成功 400 配置失败,语义有误,当前请求无法被服务器理解,或参数有误
SparkRTC支持本地服务端录制,但未完全开放,如需使用请提交工单联系华为技术工程师。 本地服务端录制需要使用Linux SDK,可部署在客户Linux 服务器上,使用客户自有的服务器和存储资源。 云端录制无需部署客户自有Linux服务器,减轻了研发和运维的压力,更轻量便捷。 父主题: 录制相关
查询增值(录制)事件回调配置 功能介绍 调用此接口查询增值(录制)事件回调配置 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v2/apps/{app_id}/record-callback
Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息。 响应参数 状态码: 200
自动录制配置 更新自动录制配置 查询自动录制配置
入门指引 首次使用SparkRTC,您需要完成如下操作: 注册华为账号:单击进入注册页面。 完成实名认证:单击进入实名认证。 账户充值:为确保正常使用SparkRTC,您需要进行账户充值(超过1元)。 提交工单联系华为云技术客服,进行业务咨询。 图1 入门流程 SparkRTC的入门操作流程说明如表1所示。
500 删除配置失败,服务器端错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError" } 状态码 状态码 描述 204 删除配置成功 400 删除配置失败,语义有误,当前请求无法被服务器理解,或参数有误
HRTC码率帧率配置推荐 父主题: 接口参考
云资源授权:在SparkRTC服务中对存储录制文件的OBS桶进行授权,允许SparkRTC服务将录制文件存储在对应的OBS桶中。 配置录制规则:为实时音视频互动配置录制规则,配置完成后,就可以使用录制规则ID开启录制任务,录制内容按录制设置存储至OBS中。还可以通过设置回调地址获取录制任务状态通知。
500 获取配置失败,服务器端错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError" } 状态码 状态码 描述 200 获取录制规则配置成功 400 获取配置失败,语义有误,当前请求无法被服务器理解,或参数有误
和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下,其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b"
Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息。 响应参数 状态码: 200
} } 签名生成样例 为防止“app_key”密钥泄漏,建议您配置自己的应用签名分发服务器,向服务器传入“app_id”、“room_id”,“user_id”和“ctime”后,由服务器返回签名。详细代码示例如下所示: 1 2 3 4 5 6 7 8
状态码: 500 配置失败,服务器端错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError" } 状态码 状态码 描述 200 配置成功 400 配置失败,语义有误,当前请求无法被服务器理解,或参数有误
Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息,与路径参数中的项目ID相同。
19:对端用户无帧率 20:本端服务器下行无码流 21:本端服务器下行无帧率 abnormal_factor_desc String 异常因素描述,支持国际化 当异常类型为1时,异常因素描述与异常因素对应,取值范围为: 建链失败 房间非空闲 服务器异常 服务器反馈503 鉴权失败 鉴权重试