如何接收回调事件

最近更新时间:2026-03-19 18:16:28

用户将摄像头接入天翼云智能视图服务并为设备绑定回调模板,当关联的回调事件触发时,天翼云将发送请求至用户配置的服务器地址,用户服务器负责应答请求,可获取到包含回调事件信息的 JSON 数据包。

回调事件现支持设备状态、流状态、录制事件以及AI事件回调。

整体流程

  1. 用户先创建设备,创建回调模板时配置回调URL,将回调模板绑定至设备。
  2. 设备注册上线使用。
  3. 当设备上有状态事件发生时,智能视图服务会向用户服务器地址发送事件消息。

回调事件通知协议

网络协议

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

通知可靠性

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

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

回调事件配置方式

用户可在控制台或通过OpenAPI进行回调配置,支持对录制、设备状态、流状态、AI事件通知等配置独立回调URL。

控制台操作流程:

  1. 点击智能视图服务控制台左侧【模板管理-回调模板】菜单,创建回调模板。
  2. 在回调模板页面点击【绑定设备】勾选需配置回调模板的设备,也可在【设备管理】页面选择目标设备切换至【配置信息】页进行绑定。

OpenAPI操作流程:

  1. 调用创建回调模板API,设置回调URL。
  2. 调用创建回调规则API,将回调模板绑定至生效设备。

回调事件参数说明

设备成功绑定回调模板后,当触发相应的回调事件时,天翼云将发送包含回调事件信息的JSON包至用户服务器地址,回调事件信息具体参数说明如下: