如何接收回调事件通知

最近更新时间:2025-02-21 02:50:53

当摄像头接入天翼云视频监控服务过程中,关联回调模板事件被触发时,天翼云将主动发送请求到客户服务器,客户服务器负责应答请求。验证通过后,您可被动获取到包含回调事件信息的 JSON 数据包。
目前回调事件触发通知支持事件包括:设备状态、截图等事件通知。

1. 整体流程

  1. 客户在控制台配置事件通知 URL 以及截图等相关功能。
  2. 摄像头进行推流。
  3. 当视频监控服务内部有事件发生时,消息将会经由事件通知服务统一回调给客户后台服务器。

2. 回调事件通知协议

2.1 网络协议

  • 请求:HTTP POST 请求,包体内容为 JSON,每一种消息的具体包体内容参见后文。
  • 应答:HTTP STATUS CODE = 200,服务端忽略应答包具体内容,为了协议友好,建议客户应答内容携带{"code":0}

2.2 通知可靠性

事件通知服务具备重试能力,重试间隔为60秒,总计重试3次。为了避免重试对您的服务器以及网络带宽造成冲击,请保持正常回包。触发重试条件如下:

  • 长时间(20 秒)未回包应答。
  • 应答 HTTP STATUS 不为200。

3. 回调事件配置方式

用户可在控制台进行回调配置。
视频监控回调事件通知 URL 支持对设备状态事件、截图事件等配置独立回调 URL。

3.1 视频监控控制台

  1. 进入视频监控控制台的【模板管理】>【回调模板】,创建回调模板。
  2. 在【业务组管理】找到您需操作的业务组,单击【业务组配置】>【模板配置】,将此业务组与回调模板进行关联。

4. 回调事件参数说明

回调模板关联业务组成功后。当摄像头推流过程中触发回调模板事件,天翼云将主动发送包含回调事件信息的 JSON 包到客户服务器,回调事件信息具体参数说明如下:

  1. 设备状态事件通知
  2. 流状态事件通知
  3. 录制事件通知
  4. 截图事件通知
  5. AI事件通知