MQTT 应用端订阅


MQTT 应用端订阅

MQTT 应用端订阅通常也称为 MQTT 服务器订阅,用来支持第三方应用订阅设备的实时消息。ThingsCloud 不仅支持服务器订阅,也支持第三方应用的浏览器端通过 MQTT@Websocket 直接订阅设备实时消息,用于在 Web 页面实时更新设备数据和可视化界面。

提示

ThingsCloud 提供给第三方应用的 MQTT 应用端订阅服务,和设备 MQTT 接入的并不是同一个 MQTT 服务,请您使用专有的 MQTT 应用端订阅服务地址和主题。

支持订阅哪些消息?

应用端通过 MQTT 应用端订阅可以获得的消息包括:

  • 设备属性上报
  • 设备事件上报
  • 设备命令回复
  • 设备告警
  • 设备上线

MQTT 连接证书

项目 > 设置 > MQTT 应用端订阅 中,可以获得 MQTT 证书,包括:

  • ProjectViewKey:作为 MQTT username
  • ProjectViewSecret:作为 MQTT password

支持的连接方式

MQTT 应用端订阅支持以下连接方式:

  • MQTT 普通方式:适合运行在服务器端的应用,可通过服务器端程序接收实时消息,写入自有数据库或实现其它逻辑。
  • MQTT@Websocket:适合基于浏览器的应用,实时更新设备状态或数据图表,可以通过 Websocket 连接并获得实时消息。

MQTT 地址

MQTT 应用端订阅功能对企业版用户开放,请联系技术支持获得详细使用说明。

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>/alarm

订阅项目内所有设备告警消息

包含告警触发和告警恢复。

<ProjectViewKey>/+/alarm

订阅指定设备上线通知

<ProjectViewKey>/<DeviceViewToken>/online

订阅项目内所有设备上线通知

<ProjectViewKey>/+/online