MQTT 应用端订阅
约 652 字大约 2 分钟
MQTT 应用端订阅
ThingsCloud 支持开放的 MQTT 应用端订阅服务,帮助您在自有软件应用或第三方应用中实时接收设备的最新消息。
您不仅可以在服务器上订阅设备消息,也可以在基于浏览器的 Web 应用中通过 Javascript 和 MQTT@Websocket 直接订阅设备实时消息,来实现 Web 页面实时更新设备数据,这在开发物联网数据可视化界面时发挥重要的作用。
提示
ThingsCloud 提供的 MQTT 应用端订阅服务,和设备的 MQTT 接入并不是同一个 MQTT 服务,请您使用专用的 MQTT 应用端订阅服务地址和主题。
MQTT 应用端订阅功能对企业版及以上项目开放。
支持订阅哪些消息?
应用端通过 MQTT 应用端订阅可以获得的消息包括:
- 设备属性变化(包括属性上报、属性下发、云端属性更新)
- 设备事件上报
- 设备命令回复
- 设备自定义数据上报
- 设备告警/恢复
- 设备上线/下线
MQTT 连接参数
在 项目 > 设置 > MQTT 应用端订阅 中,可以获得 MQTT 连接参数,包括:
参数 | 说明 |
---|---|
MQTT 地址 | 包含服务器地址和端口号。采用 wss:// 连接方式,支持服务器端或网页端使用。 |
Username | 使用 ProjectViewKey |
Password | 使用 ProjectViewSecret |
MQTT 订阅主题
以下主题中的字段说明:
<ProjectViewKey>
:项目内唯一,可在 项目 > MQTT 应用端订阅 中获得。<DeviceViewToken>
:每个设备唯一,可在设备详情页中获取,或通过 项目 HTTP API 获取。+
:表示通配符的主题,可订阅项目中的所有设备。
订阅指定设备属性变化
<ProjectViewKey>/<DeviceViewToken>/attributes
订阅项目内所有设备属性变化
<ProjectViewKey>/+/attributes
订阅指定设备事件上报
<ProjectViewKey>/<DeviceViewToken>/event/report
订阅项目内所有设备事件上报
<ProjectViewKey>/+/event/report
订阅指定设备命令回复
<ProjectViewKey>/<DeviceViewToken>/command/reply
订阅项目内所有设备命令回复
<ProjectViewKey>/+/command/reply
订阅指定设备自定义数据上报
<ProjectViewKey>/<DeviceViewToken>/data
订阅项目内所有设备自定义数据上报
<ProjectViewKey>/+/data
订阅指定设备告警消息
包含告警触发和告警恢复。
<ProjectViewKey>/<DeviceViewToken>/alarm
订阅项目内所有设备告警消息
包含告警触发和告警恢复。
<ProjectViewKey>/+/alarm
订阅指定设备上线通知
<ProjectViewKey>/<DeviceViewToken>/online
订阅项目内所有设备上线通知
<ProjectViewKey>/+/online