检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SparkRTC是否支持本地服务端录制? SparkRTC支持本地服务端录制,但未完全开放,如需使用请提交工单联系华为技术工程师。 本地服务端录制需要使用Linux SDK,可部署在客户Linux 服务器上,使用客户自有的服务器和存储资源。 云端录制无需部署客户自有Linux服务器,减轻了研发和运维的压力,更轻量便捷。
图1 添加录制回调地址 回调地址:接收回调信息的服务器地址,仅支持HTTP和HTTPS协议。 回调秘钥:录制回调的鉴权密钥,鉴权串长度范围:[32,64]。录制回调鉴权签名的生成方法,请参考《常见问题》的“如何对录制回调进行鉴权?”章节。 回调示例 录制文件生成事件回调示例如下。回调消息体字段如表1所示。
参数 参数类型 描述 rule_id String 规则id,由服务端返回。创建或修改规则的时候不携带 app_id String 应用id obs_addr RecordObsFileAddr object 保存录制文件所在的桶信息 record_formats Array of strings
状态码: 500 修改失败,服务器错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError" } 状态码 状态码 描述 200 修改成功 400 修改失败,语义有误,当前请求无法被服务器理解,或参数有误
AppCallbackUrl 参数 参数类型 描述 url String 回调通知url地址,url必须以http://或https://开头,需要支持POST调用。 auth_key String 回调密钥,主要用于鉴权。如果不设置或者为空,则回调不会增加鉴权头域字段。 notify_event_subscription
更新录制规则 功能介绍 调用此接口更新录制规则。 接口约束 如果规则修改后,修改后的规则对正在录制的流无效。 修改后对新的流有效,生效时间为5分钟,即修改规则5分钟后的录制任务会使用新规则进行录制。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API E
参数 参数类型 描述 rule_id String 规则id,由服务端返回。创建或修改规则的时候不携带 app_id String 应用id obs_addr RecordObsFileAddr object 保存录制文件所在的桶信息 record_formats Array of strings
omServerError 90000020 加入房间服务器错误 加入房间服务器错误。 HWRtcErrorCodejoinRoomServiceUnreachable 90000021 加入房间服务器无法访问 加入房间服务器无法访问。 HWRtcErrorCodejoinRoomAuthFail
端到端加密参数 属性 类型 描述 cryptionMode HRTCCryptionMode 加密模式 cryptionSec String 加密密钥,仅sdk加密模式下需要设置。必须是长度大于等于32的16进制字符串。 suiteType HRTCSuiteType 加密算法,
获取当前网络传输状况统计数据。 getLocalAudioStats 获取本地音频统计数据。 getLocalVideoStats 获取本地视频统计数据。 getRemoteAudioStats 获取远端音频统计数据。 getRemoteVideoStats 获取远端视频统计数据。 enableTopThreeAudioMode
} } 签名生成样例 为防止“app_key”密钥泄漏,建议您配置自己的应用签名分发服务器,向服务器传入“app_id”、“room_id”,“user_id”和“ctime”后,由服务器返回签名。详细代码示例如下所示: 1 2 3 4 5 6
非法请求。 建议直接修改该请求,不要重试该请求。 401 Unauthorized 在客户端提供认证信息后,返回该状态码,表明服务端指出客户端所提供的认证信息不正确或非法。 403 Forbidden 请求被拒绝访问。 返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,
请求Body参数 参数 是否必选 参数类型 描述 url 是 String 回调通知url地址,url必须以http://或https://开头,需要支持POST调用。 auth_key 否 String 回调密钥,主要用于鉴权 响应参数 状态码: 200 表4 响应Header参数 参数 参数类型
500 修改单流任务失败,服务器错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError" } 状态码 状态码 描述 200 任务修改成功,返回job的概要信息,如包含job_id 400 修改单流任务
AppCallbackUrl 参数 参数类型 描述 url String 回调通知url地址,url必须以http://或https://开头,需要支持POST调用。 auth_key String 回调密钥,主要用于鉴权。如果不设置或者为空,则回调不会增加鉴权头域字段。 notify_event_subscription
用户昵称,该昵称为UTF-8编码。 signature:必选,string[512]类型,鉴权签名字串,应用开发者需要向远端服务器获取鉴权签名。 远端服务器需要您自行部署,具体请参见接入鉴权。 ctime:必选,string类型,签名UTC时间戳,单位秒。 role:必选,num
描述 201 任务创建成功,返回job的概要信息 400 创建合流任务失败,语义有误,当前请求无法被服务器理解,或参数有误 404 app编号不存在 500 创建合流任务失败,服务器错误 错误码 请参见错误码。 父主题: 合流任务管理
19:对端用户无帧率 20:本端服务器下行无码流 21:本端服务器下行无帧率 abnormal_factor_desc String 异常因素描述,支持国际化 当异常类型为1时,异常因素描述与异常因素对应,取值范围为: 建链失败 房间非空闲 服务器异常 服务器反馈503 鉴权失败 鉴权重试
AppCallbackUrl 参数 参数类型 描述 url String 回调通知url地址,url必须以http://或https://开头,需要支持POST调用。 auth_key String 回调密钥,主要用于鉴权。如果不设置或者为空,则回调不会增加鉴权头域字段。 notify_event_subscription
19:对端用户无帧率 20:本端服务器下行无码流 21:本端服务器下行无帧率 abnormal_factor_desc String 异常因素描述,支持国际化 当异常类型为1时,异常因素描述与异常因素对应,取值范围为: 建链失败 房间非空闲 服务器异常 服务器反馈503 鉴权失败 鉴权重试