直播录制流新状态回调,录制完成后会通知文件生成事件以及录制状态。

注意事项

控制台配置回调地址,默认只有文件生成事件通知。如果需要录制状态通知,需要先调用AddLiveRecordNotifyConfig接口,设置NeedStatusNotify = true。

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

操作步骤

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

  1. 登录 视频直播控制台
  2. 单击 域名管理
  3. 选择所需的播流域名,并单击 模板管理

  4. 在左侧导航栏中单击 录制配置,并选择 存储至OSS

  5. 单击 回调地址 右侧的 添加
  6. 回调设置 中,输入 回调地址

    说明 由于安全原因,录制回调不可以回调内网地址。必须为一个有效的公网地址。

示例

用户回调地址: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分别为录制域名、应用名和流名,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"
    
    }