MQTT客户端使用指南
更新时间：2020-01-15
MQTT.fx
MQTT.fx 是目前主流的mqtt客户端，可以快速验证是否可以与IoT Hub 服务交流发布或订阅消息。设备将当前所处的状态作为MQTT主题发送给IoT Hub，每个MQTT主题topic具有不同等级的名称，如“建筑/楼层/温度。” MQTT代理服务器将接收到的主题topic发送给给所有订阅的客户端。
连接IoT Hub服务
登录MQTT.fx下载页面，找到适合的版本下载并安装MQTT.fx客户端。
-
打开MQTT客户端的设置页面，点击“+”按键，创建一个新的配置文件。
- 填写Connection profile相关信息：
| 参数名称 | 说明 |
|---|---|
| profile name | 配置文件名称 |
| Broker Address | 创建endpoint后返回的hostname |
| Broker Port | ssl加密连接方式，端口使用1884；tcp不加密连接，端口使用1883。 |
| Client ID | 客户端ID，支持“a-z”,“0-9”,“_”,“-”字符，且不能大于128bytes，UTF8编码。在同一个实例下，每个实体设备需要有一个唯一的ID，不同实体设备使用同一个client id建立连接会导致其它连接下线 |
- 选择User Credential，输入创建 IoT Hub 服务返回的username/password。
-
如果您选择SSL安全认证方式连接IoT Hub 服务，需要配置SSL/TLS安全认证，勾选
Enable SSL/TLS，选择CA signed server certificate认证。如您选择TCP连接，无需配置SSL安全认证，执行第4步骤即可。
- 点击“Apply”按键，完成客户端配置。
- 返回MQTT客户端界面，选择新创建的配置文件，点击“connect”按键连接服务。
订阅消息
注意：
IoT Hub一个主题支持的层级最多是9层（也就是最多只能出现8个斜线"/"）。
成功连接IoT Hub 服务后，即可开始订阅消息。
打开Subscribe标签，填写主题topic，例如building-b/floor-5/temperature-1，选择默认的QoS 0，点击“Subscribe”进行订阅操作。
发布消息
打开Publish标签，填写主题topic，例如building-b/floor-5/temperature-1，选择默认的QoS 0，点击“Publish”进行发布操作。
返回Subscribe界面，即可看到已接收的订阅消息，参见下图。
