如何接收回调事件通知
最近更新时间:2025-02-21 02:50:53
当摄像头接入天翼云视频监控服务过程中,关联回调模板事件被触发时,天翼云将主动发送请求到客户服务器,客户服务器负责应答请求。验证通过后,您可被动获取到包含回调事件信息的 JSON 数据包。
目前回调事件触发通知支持事件包括:设备状态、截图等事件通知。
1. 整体流程
- 客户在控制台配置事件通知 URL 以及截图等相关功能。
- 摄像头进行推流。
- 当视频监控服务内部有事件发生时,消息将会经由事件通知服务统一回调给客户后台服务器。
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 视频监控控制台
- 进入视频监控控制台的【模板管理】>【回调模板】,创建回调模板。
- 在【业务组管理】找到您需操作的业务组,单击【业务组配置】>【模板配置】,将此业务组与回调模板进行关联。
4. 回调事件参数说明
回调模板关联业务组成功后。当摄像头推流过程中触发回调模板事件,天翼云将主动发送包含回调事件信息的 JSON 包到客户服务器,回调事件信息具体参数说明如下:
本页目录: