文档

如何设置录制回调

更新时间:

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

注意事项

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

操作步骤

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

  1. 登录视图计算控制台。 

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

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

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

说明

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

文件生成事件回调示例。

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

{
  "domain": "live.aliyunlive.com",
  "app": "live",
  "stream": "hello",
  "uri": "live/hello/0_2017-03-08-23:09:46_2017-03-08-23:10:40.flv",
  "duration": 69.403,
  "start_time": 1488985786,
  "stop_time": 1488985840
}
		

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

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

{
"domain": "live.aliyunlive.com",
"app": "live",
"stream": "hello",
"event": "record_started"
}
		

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

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

{
"domain": "live.aliyunlive.com",
"app": "gs_app",
"stream": "gs_stream",
"event": "record_paused"
}
		

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

{
"domain": "gs_domain",
"app": "gs_app",
"stream": "gs_stream",
"event": "record_error"
}