前言
很多矿山智能化项目，UWB 人员定位、视频监控、集群对讲各自独立部署。定位产生越界、SOS 告警后，无法自动推送到调度平台联动音视频。本文将记录定位系统通过 WebHTTP 接口，将告警事件推送到融合通信底座的对接方案、报文样例、异常处理，项目采用华脉智联 Hlink融合通信平台做上层调度服务。
环境说明
- 定位系统：UWB 人员定位服务器，对外提供 HTTP WebAPI
- 对接方式：POST HTTP 请求，JSON 报文推送告警事件
- 接收平台：Hlink 融合通信平台事件网关服务
- 网络：工业局域网，单向推送，定位服务作为客户端，主动上报事件
一、对接整体流程
告警事件由 UWB 定位服务主动发起推送：
- 定位系统检测事件（SOS 报警 / 电子围栏越界 / 人员静止滞留）
- 封装 JSON 告警报文，携带人员 ID、标签号、坐标、告警类型、时间戳
- POST 请求发送至 Hlink 平台事件网关接口
- Hlink 网关校验签名、解析报文，存入事件中心
- 平台触发联动逻辑：GIS 点位高亮、拉取附近 GB28181 摄像头、触发区域集群对讲
- 平台返回 ack 应答；定位系统收到应答，代表推送成功；无应答则触发重试
二、接口定义与报文示例
接口地址（示例）
POST http://192.168.1.100:8090/api/event/report请求头
Content-Type: application/json
Authorization: Bearer {token}请求 Body 示例
{
"eventId":"ALM20261016001",
"eventType":"PERSON_SOS",
"personId":"U00125",
"tagNo":"TAG0896",
"personName":"张XX",
"posX":125.36,
"posY":78.12,
"areaName":"原煤破碎机车间",
"alarmTime":"2026-10-16 14:22:35",
"alarmDesc":"作业人员按下SOS紧急报警"
}平台成功应答返回：
{
"code":200,
"msg":"success",
"data":{
"receiveId":"EVT987654"
}
}三、关键对接注意事项
- 时间戳统一 两套服务器必须统一时区为 Asia/Shanghai。调试时遇到过：定位服务器 UTC 时间，融合平台北京时间，告警事件时序错乱，事件展示顺序颠倒。对接初期优先校验时间同步。
- 消息重传与幂等 工业网络存在抖动，报文丢包很常见。定位侧需要增加重试机制：推送后 3s 没有收到 200 应答，则重复推送，最多重试 3 次。
重点：eventId 必须全局唯一，Hlink 平台基于 eventId 做幂等校验，防止重复告警多次触发对讲。
- 权限与账号同步 定位系统人员台账需要定时同步至融合平台。可新增定时拉取接口，Hlink 平台每 30min 拉取一次人员名单、所属班组、对讲账号。避免出现：告警来了，平台找不到对应对讲账号，无法呼叫。
四、联动逻辑（平台侧）
当 Hlink 收到PERSON_SOS事件，内部自动执行：
- 在 GIS 地图标记该人员实时坐标；
- 根据坐标匹配预设摄像头点位，自动拉取 GB28181 视频流；
- 匹配区域分组，一键呼叫该区域所有在线对讲终端；
- 对讲通话全程录音，AI 转写文本，告警信息 + 音视频记录存入事件档案，可用于安监复盘。
五、调试阶段常见问题
- 报文字段大小写不匹配，网关解析失败。约定全部采用小驼峰或者下划线命名，前后端统一规范。
- 内网防火墙拦截 8090 端口，报文直接无法送达。提前放通双向策略。
- 定位上报坐标是局部相对坐标，不是 GIS 地图坐标系，点位偏移。对接前期要做坐标映射转换。
六、小结
这套方案不需要改动原有 UWB 定位硬件，只在软件层面打通事件推送。定位系统负责感知，华脉智联Hlink 融合通信平台承接事件调度，实现告警到指挥的闭环。适合选煤厂、洗煤厂智能化改造项目，保护存量设备投资。
工业多系统集成，接口规范、幂等、重试、时间同步，是最容易忽略但是直接决定系统稳定性的关键点。