Appearance
使用指南
初始化配置
- 获取 AppKey（请联系管理员）
- 获取 MQTT 地址、用户名、密码（请联系管理员）
- 成功连接 MQTT 之后，订阅消息响应主题和数据接收主题
- 开启实时推送（默认开启，无需配置）
- 配置定时推送（默认开启，无需配置。默认推送频率：实时数据 30 分钟，设备状态 10 分钟）
数据查询（发布主题）
通过向请求主题 /openapi/data/request/{appKey} 发布消息来发送请求。
接收数据推送（订阅主题）
订阅以下主题，接收响应数据和推送数据：
| 主题 | 说明 |
|---|---|
/openapi/data/response/{appKey} | 数据响应主题 |
/openapi/data/scheduled/{appKey} | 数据推送主题 |
解释说明
QoS
QoS 1：保证消息至少送达一次，推荐使用。
数据推送
数据变化都会向第三方主动推送。
数据测试
推荐使用 MQTT 的官方工具 MQTTX 进行测试，方便进行主题发布、订阅、数据接收等。
名词说明
| 名词 | 说明 |
|---|---|
| 区域 | 树形节点结构，例如"广东省-深圳市-南山区-机房"就是一个 4 层树形节点的区域。区域可以看做是一个设备分组 |
| 设备 | 属于一个区域节点，例如机房、基站下的设备。可以先获取区域节点，再通过区域节点去获取区域下面的设备，也可以一次性获取全部设备 |
| 属性量 | 实时数据里面的属性量，例如温湿度设备包含温度和湿度两个属性量 |
| 产品 | 设备的属性量汇总，例如温湿度设备除了温度和湿度，还有信号、电量等，这些属性量可以通过获取产品去获取 |