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

回调配置方式

直播录制回调支持控制台和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"
      }
    }

参考文档

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