跳至主要內容

MQTT 应用端订阅

约 652 字大约 2 分钟

MQTT 应用端订阅

ThingsCloud 支持开放的 MQTT 应用端订阅服务,帮助您在自有软件应用或第三方应用中实时接收设备的最新消息。

您不仅可以在服务器上订阅设备消息,也可以在基于浏览器的 Web 应用中通过 JavascriptMQTT@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