MQTT 集成
功能路径:SVE 导航栏 → 结果集成 → MQTT
功能简介
智能相机作为 MQTT 发布者(Publisher),将 AI 推理结果以 JSON 消息发布到 MQTT Broker 的指定 Topic,由 Broker 路由给订阅方(MES / 上位机 / 网关)。MQTT 传结果消息(含图片链接),图片本体走文件通道,按需获取。
集成要求
| 项 | 要求 |
|---|---|
| MQTT Broker | 可被相机访问,已在指定端口(默认 1883)开启 TCP 服务 |
| Broker地址 | Broker IP(相机可达) |
| 端口 | MQTT 服务端口(默认 1883,以服务器实际为准) |
| Client ID | 全局唯一(各相机不可重复,冲突会被"顶号") |
| Topic | 相机上报主题,按现场约定(如 camera/<deviceId>/result) |
| QoS | 0 / 1 / 2(按可靠性要求选择) |
| 鉴权 | Broker 若开启账号密码鉴权,相机需能提供对应凭据 |
| 消息格式 | JSON(含 appId / cameraId / timestamp / originImg / finalImg 等) |
SVE 上基本配置
- 进入 结果集成 → MQTT;
- 打开 MQTT集成 开关;
- 填写连接参数:
| 参数 | 说明 |
|---|---|
| Broker地址 | MQTT Broker IP |
| 端口 | MQTT 服务端口(默认 1883) |
| Client ID | 点 生成 或自定义唯一值 |
| Topic | 相机上报主题 |
| QoS | 0 / 1 / 2 |
- 点击 保存。
基本验证
页面联调(测试发布)
配置完成后点击 测试发布,观察右侧「联调请求」区域:显示发布成功即链路正常。可在 Broker 侧订阅该 Topic 看到对应测试消息。
真实任务验证
- 在 任务管理 → AI 应用 中对该应用触发「运行预览」,完成一次推理过件;
- 在 Broker 侧使用任意 MQTT 订阅客户端订阅相机上报的 Topic,出现相机上报的主题与 JSON(含
originImg/finalImg链接)→ 集成成功。
常见问题
| 现象 | 排查 |
|---|---|
| 连不上 Broker | Broker 是否运行、端口是否可达;同网段、防火墙 |
| 发布但订阅看不到 | Topic 层级与订阅通配符是否匹配;QoS/RETAIN 设置 |
| 认证失败(not authorised) | Broker 开鉴权,相机需配置正确账号密码 |
| 相机掉线/重连 | ClientID 是否唯一;网络是否稳定 |