全部产品
云市场

如何设置录制回调

更新时间:2019-03-11 12:30:38

视频监控录制新状态回调,录制完成后会通知用户相应的结果以及录制状态。

注意事项

支持配置HTTP/HTTPS URL,向用户服务器发送POST请求、消息体JSON格式,将录制结果和状态信息实时反馈给用户,用户服务器通过200响应返回接口返回结果。URL无需标识,能正常访问即可。如果访问超时,可以重试5次,每次重试的间隔时间为随机值,范围在100ms到10s之间。

操作步骤

您可以在控制台自主配置录制回调地址。

  1. 登录 视频监控控制台

  2. 单击导航栏的 模版管理,单击 录制模版

  3. 录制模版 页,点击 添加录制模版

  4. 录制模版详情页录制回调地址 处填写,完成后单击 创建

说明 由于安全原因,录制回调不可以回调内网地址。必须为一个有效的公网地址。示例用户回调地址:http:// 1.1.1.1/notify/record返回的body内容如下。

文件生成事件回调示例

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

  1. {
  2. "domain": "live.aliyunlive.com",
  3. "app": "live",
  4. "stream": "hello",
  5. "uri": "live/hello/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分别为空间的域名、live和流名,uri为目标录制文件在用户录制OSS Bucket下的路径。duration、start_time、stop_time分别为目标录制文件录制内容时长和起止时间。

录制状态回调示例(当 NeedStatusNotify=true 时产生)录制开始事件回调,表示录制已经成功开始。试用

  1. {
  2. "domain": "live.aliyunlive.com",
  3. "app": "live",
  4. "stream": "hello",
  5. "event": "record_started"
  6. }

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

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

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

录制错误事件回调,表示录制出现错误信息。试用

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