Skip to content

平台对接

12.1 功能说明

平台对接模块用于配置系统与第三方平台的对接,包括云平台、推送(HTTP推送、邮件推送、企业微信)、GB28181、视图库、ONVIF、智联中枢和合作方。通过平台对接,可将AI分析结果推送到外部系统,或接入外部设备。

进入方式:登录系统后,点击顶部导航栏的"平台对接"菜单,系统默认进入"云平台"子页面。

平台对接

12.2 云平台

云平台用于将本设备接入上级平台(如上级运维设备或云平台),实现设备管理和告警数据推送。

使用场景:

以B设备(子设备)接入A设备(上级运维设备)为例:

  1. 在B设备(子设备)配置云平台:在本设备的云平台页面,填写上级设备的IP和端口(默认50051),设置需要推送的内容并启用。
  2. 在A设备(上级平台)添加设备:在上级设备的设备管理中新增设备,填写本设备的IP和序列号。

说明:上级平台是根据序列号来唯一确定设备的,而不是根据IP。因此,即使本设备填写的上级IP不正确、或者上级平台无法直接连接到本设备的IP,也不影响上级平台接收本设备推送的告警信息。这种情况常见于上级平台在公网、本设备在内网的单通场景。

配置参数:

字段说明
上级IP上级平台的IP地址
端口上级平台端口,默认50051
是否启用开启后开始向上级平台推送
是否上传视频是否推送视频
是否上传警告图是否推送告警图片

操作步骤:

  1. 进入"平台对接 > 云平台"页面。
  2. 填写上级平台IP和端口(默认50051)。
  3. 根据需要勾选是否上传视频、告警图。
  4. 设置启用状态为"启用"。
  5. 点击"保存"。
  6. 点击"测试连接",测试本设备是否能连通上级平台,测试通过即可正常使用。

云平台配置

注册说明:

  • AI边缘运维服务器必须注册后才能管理下级设备和接收推送信息。
  • AI边缘节点作为运维使用时,若管理的设备数量达到3个及以上,也需要注册才能接收下级设备推送的信息;若只管理自身或管理设备不满3个,则不需要注册也能正常接收推送。

12.3 推送

推送模块用于将系统产生的告警事件推送到第三方平台或通知渠道。在左侧子菜单中展开"推送"后,包含以下三个子页面:HTTP推送、邮件推送、企业微信。

12.3.1 HTTP推送

HTTP推送用于将AI分析事件通过网络请求推送到第三方系统。

配置参数:

字段说明
推送URL接收推送的URL地址
是否启用1:启用;2:不启用
绑定本地IP推送使用的本地网卡IP
HTTP方法GET/POST等
图片类型列表推送的事件类型(空代表所有)

测试推送:

  • 点击"测试"按钮,可发送测试请求验证推送URL是否可达。
  • 系统支持测试HTTP推送和测试URL连接。

HTTP推送配置

告警推送内容格式:

HTTP推送旁边的问号图标中包含告警推送内容的详细格式说明,点击问号可查看推送数据的字段和结构。

HTTP推送内容格式

12.3.2 邮件推送

邮件推送用于将报警事件通过邮件发送到指定邮箱。

发件人配置:

字段说明
服务器发件邮箱的服务器地址
端口发件邮箱的服务器端口
用户名发件邮箱账号
授权码/密码发件邮箱的授权码或密码
发件人发件人显示名称,可自定义

收件人配置:

字段说明
收件人收件人序号,系统自动排序为1、2、3…
邮箱收件人邮箱地址
推送内容需要推送的内容类型
图片类型推送的事件图片类型

测试发送:

  • 填写收件人邮箱后,点击"测试发送"可发送测试邮件验证配置是否正确。

邮件推送配置

QQ邮箱配置示例:

以QQ邮箱为例,各字段填写方式如下:

字段填写内容说明
服务器smtp.qq.comQQ邮箱的SMTP服务器地址
端口465QQ邮箱SMTP的SSL端口
用户名你的QQ邮箱号@qq.com完整的QQ邮箱地址
授权码/密码在QQ邮箱设置中获取的授权码不是QQ登录密码,需在QQ邮箱"设置 > 账户 > POP3/SMTP服务"中开启并获取授权码
发件人自定义名称,如"AI告警系统"可随意填写,收件人看到的发件人名称

提示:QQ邮箱的授权码不是QQ密码,需要登录QQ邮箱网页版,进入"设置 > 账户",找到"POP3/SMTP服务"并开启,按提示用手机发送短信获取授权码。

12.3.3 企业微信

当系统产生告警事件时,自动将告警信息推送到指定的企业微信群,便于相关人员及时响应。

企业微信推送功能通过企业微信群消息推送的 Webhook 地址,将系统的告警事件实时推送到企业微信群。支持配置最多3个 Webhook 地址,可同时推送到不同的群组。

前提条件:获取企业微信群 Webhook 地址

在使用企业微信推送功能之前,需要先在企业微信群中添加消息推送并获取 Webhook 地址:

  1. 打开企业微信,进入需要接收告警的群聊。

  2. 点击群聊右上角的「...」,找到「消息推送」。

    企业微信群消息推送入口

  3. 在「消息推送」中点击「添加」,填写名称(如「边缘告警通知」)。

    添加消息推送

  4. 创建完成后,即可看到 Webhook 地址,格式如下:

    获取Webhook地址

    https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  5. 复制该地址备用。

提示

  • 如果需要推送到多个群,重复上述操作为每个群创建一个消息推送。
  • 请妥善保管 Webhook 地址,避免泄露后被恶意调用。

操作步骤:

第一步:进入企业微信推送配置页面

登录系统网页控制台,进入「平台对接 > 企业微信」页面。

企业微信推送配置页面

第二步:填入 Webhook 地址并启用

  1. 在 Webhook 配置区域,将获取的 Webhook 地址填入对应的输入框中。
  2. 点击该 Webhook 对应的「启用」按钮,状态变为已启用即表示配置生效。
  3. 如需配置多个 Webhook,依次在其他输入框中填入地址并启用(最多3个)。

启用Webhook

配置完成后,系统会在产生告警事件时自动向已启用的企业微信群推送消息。

第三步:测试推送

配置完成后,建议先进行一次测试推送,验证 Webhook 地址是否正确、网络是否通畅:

  1. 在「平台对接 > 企业微信」页面,找到需要测试的 Webhook。
  2. 点击该 Webhook 对应的「测试」按钮。
  3. 系统将向该 Webhook 地址发送一条测试消息。
  4. 前往企业微信群查看是否收到测试消息。

企业微信群收到的测试消息

第四步:停止/恢复推送

如需暂停某个 Webhook 的推送:

  1. 进入「平台对接 > 企业微信」页面。
  2. 找到对应的 Webhook,点击「停用」按钮,该 Webhook 将不再推送告警消息。
  3. 如需恢复推送,再次点击「启用」即可,无需重新填入地址。

使用提示:

  • Webhook 地址必须完整,以 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key= 开头。
  • 最多支持配置3个 Webhook,可推送到不同的企业微信群。
  • 每个 Webhook 可独立启用/停用,互不影响。
  • 停用后 Webhook 地址会保留,重新启用时无需重新填入。

常见问题:

点击测试后,企业微信群收不到消息?

可能原因:

  1. Webhook 地址错误 — 核对地址是否完整,重新从企业微信群「消息推送」中复制地址。
  2. 网络不通 — 边缘设备需要能访问外网(qyapi.weixin.qq.com),检查防火墙是否拦截了出站的 HTTPS 请求。
  3. 消息推送被删除或禁用 — 确认企业微信群中的消息推送仍然存在,未被群管理员删除。

配置了多个 Webhook,为什么有的群收不到消息?

  • 确认对应 Webhook 是否为「已启用」状态。
  • 确认对应 Webhook 地址是否正确。
  • 对收不到消息的 Webhook 单独点击「测试」按钮进行验证。

12.4 GB28181

GB28181页面用于配置国标28181协议对接参数,实现视频流和报警事件的国标协议传输。本系统设备作为服务端,外部设备(如摄像头)作为客户端注册到本设备。

配置参数说明:

本系统设备作为GB28181服务端,对接需要接入的客户端设备(如摄像头、NVR等)。客户端设备注册到本设备后,本设备即可管理其视频流和接收报警事件。

服务端配置(本设备)

字段说明
SIP域国标SIP域名,一般为SIP ID的前10位数字。例如SIP ID为 34020000001110000005,则SIP域为 3402000000;SIP ID为 42010400062000000003,则SIP域为 4201040006。也有少数情况SIP域与SIP ID前10位不一致,需以实际平台配置为准
SIP ID本设备作为服务端的SIP唯一标识编号,20位数字
SIP端口本设备用于SIP通信的端口,默认5060
SIP通信方式SIP传输协议,可选TCP或UDP
本地IP本设备的IP地址,用于SIP通信绑定的本地网卡
是否启用开启后本设备作为服务端等待客户端设备注册

客户端配置(对接设备)

客户端是指要对接到本设备的设备(如摄像头、NVR等)。在本设备中添加客户端后,客户端设备注册到本设备即可接入。

字段说明
SIP ID客户端设备的SIP唯一标识编号,20位数字
SIP域客户端设备所属的SIP域名
IP客户端设备的IP地址
端口客户端设备的SIP端口
密码客户端注册时使用的密码
视频流传输方式客户端视频流的传输方式(TCP/UDP)
心跳时间客户端发送心跳的时间点,精确到秒
注册时间客户端注册的时间点,精确到秒
注册客户端的注册状态
操作删除该客户端

提示:修改客户端配置时,直接在输入框中修改内容,点击"保存"即可完成修改,无需额外操作。

海康摄像头对接示例:

以海康摄像头作为客户端注册到本设备(服务端)为例:

第一步:在本系统配置服务端

在"平台对接 > GB28181"页面,配置服务端参数:

本系统字段填写内容说明
SIP域4201040006SIP域名
SIP ID42010400062000000003本设备的服务端SIP编号
SIP端口5060默认端口
SIP通信方式UDP建议使用UDP
本地IP172.20.26.58本设备的IP地址
是否启用启用开启后等待摄像头注册

第二步:在本系统添加客户端

在GB28181页面的客户端列表中添加海康摄像头:

字段填写内容说明
SIP ID34020000001110000005海康摄像头的国标编号
SIP域3402000000海康摄像头所属的SIP域
IP172.20.20.252海康摄像头的IP地址
端口5060海康摄像头的SIP端口
密码自定义密码与海康摄像头中配置的密码一致
视频流传输方式TCP视频流传输协议

第三步:在海康摄像头端配置GB28181

登录海康摄像头的Web管理页面,进入"配置 > 网络 > 高级配置 > 平台接入",选择接入方式为"GB28181",填写以下参数:

海康摄像头字段填写内容说明
本地SIP端口5060摄像头本地SIP端口
SIP服务器ID42010400062000000003与本系统服务端SIP ID一致
SIP服务器域4201040006与本系统服务端SIP域一致
SIP服务器地址172.20.26.58即边缘设备的IP(本系统本地IP)
SIP服务器端口5060与本系统SIP端口一致
SIP用户认证ID34020000001110000005与本系统客户端SIP ID一致
密码与本系统客户端密码一致两端密码必须相同

海康摄像头GB28181配置

第四步:验证对接

  1. 保存配置后,海康摄像头会向本设备发起SIP注册请求。
  2. 在GB28181页面的客户端列表中,可以查看海康摄像头的注册状态。
  3. 注册成功后,可在视频管理中通过GB28181导入的方式添加该摄像头的视频通道。

提示

  • 海康摄像头的"服务器ID"必须与本系统服务端的"SIP ID"一致,否则无法注册成功。
  • 海康摄像头的"设备ID"必须与本系统客户端的"SIP ID"一致。
  • 如果注册不成功,请检查防火墙是否放行了SIP端口(默认5060)。

GB28181配置

12.5 视图库

视图库页面用于配置视图库对接参数,按照公安行业标准(GA/T 1400)向第三方平台推送视图数据,包括人脸、人体、非机动车、机动车等采集对象。

视图库配置

配置参数说明:

字段说明
启用开关,开启后本设备作为视图库客户端向第三方平台注册并推送数据
HTTPS开关,开启后使用HTTPS加密传输,关闭则使用HTTP
服务器IP第三方视图库平台的IP地址
服务器端口第三方视图库平台的端口号
设备ID本设备在视图库平台中的唯一标识编号
用户名在视图库平台注册的账号
密码在视图库平台注册的密码
注册间隔(秒)向服务器发起注册的时间间隔,单位秒
心跳周期(秒)向服务器发送心跳的周期,单位秒,用于保持连接
最大心跳超过次数允许心跳超时的最大次数,超过后判定为连接断开并重新注册
推送源选择推送数据的来源通道
自动上传采集开关,开启后自动上传采集到的视图数据到第三方平台
视图库采集对象选择要上传的采集对象类型,可多选:人脸、人体、非机动车、机动车

操作步骤:

  1. 进入"平台对接 > 视图库"页面。
  2. 开启"启用"开关。
  3. 根据第三方平台提供的信息,填写服务器IP、服务器端口、设备ID、用户名、密码。
  4. 根据网络环境选择是否开启HTTPS。
  5. 设置注册间隔、心跳周期和最大心跳超过次数(一般使用默认值即可)。
  6. 选择推送源。
  7. 开启"自动上传采集"开关(如需自动上传)。
  8. 在"视图库采集对象"中勾选需要上传的类型(人脸、人体、非机动车、机动车)。
  9. 点击"保存",系统会自动向第三方平台发起注册。

提示

  • 设备ID、用户名、密码需与第三方视图库平台中分配的信息一致。
  • 如果网络环境不稳定,可适当增大心跳周期和最大心跳超过次数,避免频繁断线重连。
  • 采集对象至少勾选一项,否则不会推送任何数据。

12.6 ONVIF

ONVIF页面用于通过ONVIF协议自动发现和接入网络摄像头等设备。

功能说明:

操作说明
ONVIF设备发现搜索局域网内支持ONVIF的设备,自动列出可接入的设备
新增手动输入IP、端口、账号密码添加ONVIF设备
查询按条件筛选已添加的ONVIF设备
编辑修改已添加ONVIF设备的配置信息
删除删除单个已添加的ONVIF设备
删除选择勾选多个设备后批量删除

添加ONVIF设备参数:

字段说明
IP地址设备IP
名称设备名称
管理端口HTTP端口
账号ONVIF认证账号
密码ONVIF认证密码

ONVIF

12.7 智联中枢

智联中枢提供可视化的流程编排能力,通过拖拽方式将系统与第三方系统进行灵活集成,无需编写代码即可实现数据流转和自动化处理。

智联中枢

12.8 合作方

合作方页面用于创建和管理第三方合作方,通过授权模块,使第三方能够通过合作方接口调用系统功能,而无需登录获取 token。

合作方配置

功能说明:

操作说明
新增创建合作方,填写名称和描述(描述非必填)
编辑查看和修改合作方信息,包括名称、描述、Key 和 Secret(Key 和 Secret 由系统自动生成)
授权授权模块给合作方,授权后第三方可通过合作方接口调用对应模块功能
删除删除合作方

操作步骤:

  1. 进入「平台对接 > 合作方」页面。
  2. 点击「新增」按钮,填写合作方名称和描述(描述非必填),点击保存。
  3. 创建完成后,列表中会出现该合作方信息。
  4. 点击「编辑」,可查看合作方详情,包括名称、描述、Key 和 Secret(Key 和 Secret 由系统自动生成,用于接口调用时的身份验证)。
  5. 点击「授权」,选择需要授权给合作方的模块,授权后第三方即可通过合作方接口调用对应模块的功能,无需登录获取 token。

提示

  • Key 和 Secret 是合作方调用接口的身份凭证,请妥善保管,避免泄露。
  • 如需了解合作方接口的详细使用方法,可点击页面中的「使用说明」查看。