本文介绍录制事件回调配置方式和回调内容示例。

回调配置方式

直播录制回调支持控制台和API进行配置。

回调示例

直播录制回调包括录制状态回调和文件生成回调。
  • 录制状态回调：在文件开始录制与结束录制时发出，主要表示文件已经开始和结束录制。
  • 文件生成回调：在文件生成时发出，主要包括文件名称，开始结束时间与时长信息。

回调内容为JSON格式，通过HTTP POST请求包含在请求体（Request Body）中发送到录制回调配置中的NotifyUrl接收方解析请求体获取回调内容。

  • 录制状态回调参数和示例

    说明

    通过调用接口进行回调配置，录制状态回调内容当NeedStatusNotify=true时可以产生。

    NeedStatusNotify是AddLiveRecordNotifyConfig接口的一个入参，用于表示是否需要录制任务状态回调。

    表 1. 录制状态回调参数
    参数 描述
    domain 录制的播流域名。
    app 应用名。
    stream 流名。
    event 事件名，取值：
    • record_started：录制已经成功开始。
    • record_paused：录制已经成功暂停。
    • record_resumed：录制已经成功恢复继续录制。
    录制状态回调参数示例
    {
"domain": "gs_domain",
"app": "gs_app",
"stream": "gs_stream",
"event": "record_started"
}

  • 文件生成回调参数和示例

    表 2. 文件生成回调参数
    参数 描述
    domain 录制的播流域名。
    app 应用名。
    stream 流名。
    uri 目标录制文件在用户录制OSS Bucket下的路径。
    duration 目标录制文件录制内容时长，单位：秒。
    start_time 录制开始时间。Unix时间戳，单位：秒。
    stop_time 录制结束时间。Unix时间戳，单位：秒。
    push_args 推流参数中以callback_为前缀的参数，如callback_arg1、callback_myid等。
    说明
    • 回调示例，适用于所有没有定制回调模版的客户。
    • 同一个参数名只能有一个参数值，如果传入多个值，回调仅包含第一个值。如推流参数包含callback_args1=value1&callback_args1=value2，回调中仍为"callback_args1": "value1"。
    文件生成回调参数示例
    {
  "domain": "demo.aliyundoc.com",
  "app": "liveApp****",
  "stream": "liveStream****",
  "uri": "liveApp****/liveStream****/0_2017-03-08-23:09:46_2017-03-08-23:10:40.flv",
  "duration": 69.403,
  "start_time": 1488985786,
  "stop_time": 1488985840,
  "push_args": {
    "callback_args1": "value1",
    "callback_myid": "1231389741"
  }
}

参考文档

了解更多回调信息请参见回调管理。