# MQTT 应用端订阅

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

您不仅可以在服务器上订阅设备消息，也可以在基于浏览器的 Web 应用中通过 Javascript 和 MQTT@Websocket 直接订阅设备实时消息，来实现 Web 页面实时更新设备数据，这在开发物联网数据可视化界面时发挥重要的作用。

# 支持订阅哪些消息？

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

• 设备属性上报
• 设备事件上报
• 设备命令回复
• 设备自定义数据上报
• 设备告警/恢复
• 设备上线/下线

# MQTT 连接证书

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

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

# 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>/data

# 订阅项目内所有设备自定义数据上报

<ProjectViewKey>/+/data

# 订阅指定设备告警消息

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

<ProjectViewKey>/<DeviceViewToken>/alarm

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

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

<ProjectViewKey>/+/alarm

# 订阅指定设备上线通知

<ProjectViewKey>/<DeviceViewToken>/online

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

<ProjectViewKey>/+/online