You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
37 lines
1.1 KiB
37 lines
1.1 KiB
# 使用MQTT订阅平台相关消息
|
|
|
|
在`1.5`企业版本后提供mqtt方式订阅平台消息的功能.
|
|
可以通过mqtt来订阅设备,规则引擎,设备告警等相关消息.
|
|
|
|
## 接口
|
|
|
|
通过配置:
|
|
```yml
|
|
messaging:
|
|
mqtt:
|
|
enabled: true #开启mqtt支持
|
|
port: 11883 # 端口
|
|
host: 0.0.0.0 #绑定网卡
|
|
```
|
|
|
|
## 认证
|
|
|
|
默认使用`token`(可以使用`OpenAPI`申请token)作为`clientId`,`username`和`password`可以不填写.
|
|
|
|
可通过实现接口`MqttAuthenticationHandler`来自定义认证策略.
|
|
|
|
::: warning 注意
|
|
平台topic使用的通配符为`*`，在使用MQTT订阅时需要将通配符转换为mqtt的通配符: `*`转为`+`,`**`转为`#`.
|
|
:::
|
|
|
|
## 订阅设备消息
|
|
|
|
与消息网关中的设备topic一致,[查看topic列表](../best-practices/start.md#设备消息对应事件总线topic).
|
|
消息负载(`payload`)将与[设备消息类型](../best-practices/start.md#平台统一设备消息定义)一致.
|
|
|
|
::: tip 提示
|
|
1.6版本后支持分组订阅:同一个用户订阅相同的topic,只有其中一个订阅者收到消息.
|
|
|
|
在topic前增加`$shared`即可,如: `$shared/device/+/+/#`
|
|
:::
|
|
|
|
|