视频直播产品提供录制文件回调,推流状态回调,截图文件回调,截图按需回调

录制文件回调

  1. 录制文件回调包含文件生成回调与录制状态回调,控制台添加地址后,录制状态回调默认不使用,如需要开启请提交工单处理,或者可以使用AddLiveRecordNotifyConfigAPI进行添加,设定NeedStatusNotify为true表示开启录制状态回调

    文件生成回调在文件生成时发出,主要包括文件名称,开始结束时间与时长信息

    录制状态回调在文件开始录制与结束录制时发出,主要表示文件已经开始和结束录制

  2. 录制文件生成回调配置

    录制回调(包括录制文件生成事件回调、录制任务状态回调)URL地址,详见 录制事件回调

    录制文件回调地址,用户可以在控制台配置,或者使用 AddLiveRecordNotifyConfig API进行配置。控制台配置如下图所示:

    notify_2
  3. 录制文件生成回调参数示例
    回调示例参数:
    {
      'domain': {domain},
      'app': {app},
      'stream': {stream},
      'uri': {record file url},
      'duration': {duration},
      'start_time': {start timestamp},
      'stop_time': {stop timestamp}
    }
  4. 录制文件状态回调参数示例
    文件开始录制回调示例参数:
    {
      'domain': {domain},
      'app': {app},
      'stream': {stream},
      'event': 'record_started'
    }
    文件结束录制回调示例参数:
    {
      'domain': {domain},
      'app': {app},
      'stream': {stream},
      'event': 'record_paused'
    }

推流状态回调

用来通知当前域名推流状态,如推流成功、断流状态。回调请求方式为get

  1. 推流状态回调配置
    推流状态回调地址,用户可以在控制台进行配置,或者使用SetLiveStreamsNotifyUrlConfigAPI进行配置。控制台配置如下图所示:push_1
  2. 推断流状态回调参数

    推断流状态回调会将参数封装在MultiDict内。

    推流状态回调参数示例:
    {
      'action': 'publish',
      'ip': {回调地址ip},
      'id': {推流流名},
      'app': {推流域名},
      'appname': {推流app名},
      'time': {timestamp},
      'usrargs': {用户参数},
      'node': {内部节点ip}
    }
    断流流状态回调参数示例:
    {
      'action': 'publish_done',
      'ip': {回调地址ip},
      'id': {推流流名},
      'app': {推流域名},
      'appname': {推流app名},
      'time': {timestamp},
      'usrargs': {用户参数},
      'node': {内部节点ip}
    }

截图回调

截图文件回调,截图按需回调,目前需要提工单进行配置

截图回调参数示例:
{
    "Event":"Snapshot",
    "DomainName":{域名},
    "AppName":"{app},
    "StreamName":{流名},
    "OssBucket":"bucket",
    "OssEndpoint":"oss-cn-shanghai.aliyuncs.com",
    "OssObject":"xx.jpg",
    "CreateTime":"2015-12-01T17:36:00Z",
    "SnapshotUrl":"http://bucket.oss-cn-shanghai.aliyuncs.com/xx.jpg",
    "Size":"36291",
    "Width":"1280",
    "Height":"720"
}