# MQTT 应用端订阅

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

# 支持订阅哪些消息？

应用端通过 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