全部产品
视频直播

添加录制回调配置

更新时间:2017-09-19 11:33:03   分享:   

描述

添加域名级别录制回调配置。

请求参数

参数 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:AddLiveRecordNotifyConfig
DomainName String 您的加速域名
NotifyUrl String 回调 url 地址, 必须以’http://‘ 或者 ‘https://‘ 开头,需要做 url encode
NeedStatusNotify Boolean 是否需要录制任务状态回调,可取值 true/false, 默认 false

返回参数

名称 类型 描述
RequestId String 该条任务请求 ID

特殊错误码

错误代码 描述 Http 状态码 语义
InvalidDomain.NotFound The domain provided does not exist in our records. 404 当前账户下未查到域名
MissingDomainName DomainName is mandatory for this action. 400 缺少 DomainName 值
MissingNotifyUrl NotifyUrl is mandatory for this action. 400 缺少 NotifyUrl 值
InvalidNotifyUrl.Unsafe Specified NotifyUrl is not safe. 400 非安全的 NotifyUrl 值
InvalidNofifyUrl.Malformed Specified NotifyUrl is invalid. 400 无效的 NotifyUrl 值
ConfigAlreadyExists Config has already exist. 400 配置已存在
InternalError The request processing has failed due to some unknown error, exception or failure. 500 内部错误

示例

请求示例:

  1. https://live.aliyuncs.com?Action=AddLiveRecordNotifyConfig&DomainName=test101.cdnpe.com&NotifyUrl=http://xxx<公共请求参数>

关于公共请求参数详细内容,请参考 公共请求参数

返回示例

JSON格式:

  1. {
  2. "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  3. }

文件生成事件回调示例

表示目标录制文件已经生成。

  1. {
  2. "domain": "qt01.alivecdn.com",
  3. "app": "mp4flvtest_flv",
  4. "stream": "callback_test",
  5. "uri": "mp4flvtest_flv/callback_test/0_2017-03-08-23:09:46_2017-03-08-23:10:40.flv",
  6. "duration": 69.403,
  7. "start_time": 1488985786,
  8. "stop_time": 1488985840
  9. }

其中,domain、app、stream分别为录制域名、应用名和流名,uri 为目标录制文件在用户录制 OSS Bucket 下的路径,duration、start_time、stop_time 分别为目标录制文件录制内容时长和起止时间。

录制状态回调示例,当 NeedStatusNotify=true 时产生

1. 录制开始事件回调, 表示录制已经成功开始。

  1. {
  2. "domain": "gs_domain",
  3. "app": "gs_app",
  4. "stream": "gs_stream",
  5. "event": "record_started"
  6. }

其中,domain, app, stream分别为录制域名,应用名和流名,event为事件名,可以为record_started/record_paused/record_resumed。

2. 录制暂停事件回调, 表示录制已经成功暂停。

  1. {
  2. "domain": "gs_domain",
  3. "app": "gs_app",
  4. "stream": "gs_stream",
  5. "event": "record_paused"
  6. }

3. 录制继续事件回调, 表示录制已经成功恢复。

  1. {
  2. "domain": "gs_domain",
  3. "app": "gs_app",
  4. "stream": "gs_stream",
  5. "event": "record_resumed"
  6. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?