快速使用MQTT.fx模拟SDK收发消息

使用流程

（RAM用户必选）步骤一：为RAM用户授权

若您开通消息队列服务使用的是账号是RAM用户，必须先为RAM用户进行授权，才能访问云消息队列 MQTT 版的资源。若您的账号是阿里云账号，默认拥有使用云消息队列 MQTT 版资源的权限，您可以跳过该步骤。

1. 使用RAM管理员登录RAM控制台。

2. 在左侧导航栏，选择身份管理 > 用户。

3. 在用户页面，单击目标RAM用户操作列的添加权限。

   

   您也可以选中多个RAM用户，单击用户列表下方的添加权限，为RAM用户批量授权。

4. 在新增授权面板，为RAM用户添加权限。

   1. 选择资源范围。

      • 账号级别：权限在当前阿里云账号内生效。

      • 资源组级别：权限在指定的资源组内生效。

        重要

        指定资源组授权生效的前提是该云服务及资源类型已支持资源组，详情请参见支持资源组的云服务。资源组授权示例，请参见使用资源组限制RAM用户管理指定的ECS实例。

   2. 选择授权主体。

      授权主体即需要添加权限的RAM用户。系统会自动选择当前的RAM用户。

   3. 选择权限策略。

      权限策略是一组访问权限的集合，分为以下两种。支持批量选中多条权限策略。

      • 系统策略：由阿里云创建，策略的版本更新由阿里云维护，用户只能使用不能修改。更多信息，请参见支持RAM的云服务。

        说明

        系统会自动标识出高风险系统策略（例如：AdministratorAccess、AliyunRAMFullAccess等），授权时，尽量避免授予不必要的高风险权限策略。

      • 自定义策略：由用户管理，策略的版本更新由用户维护。用户可以自主创建、更新和删除自定义策略。更多信息，请参见创建自定义权限策略。

   4. 单击确认新增授权。

5. 单击关闭。

云消息队列 MQTT 版提供以下系统策略，您可以根据权限范围为RAM用户授予相关权限。

步骤二：创建MQTT实例并获取接入点

1. 登录云消息队列 MQTT 版控制台。
2. 在左侧导航栏单击实例列表。
3. 在顶部菜单栏选择地域。
4. 在实例列表页面左上角单击创建实例。

5. 在弹出的付费方式面板中，选择按需选择包年包月或Serverless 按量付费，然后单击确定。

6. 在弹出的商品购买页中，选择实例类型和各计费项的规格，然后单击立即购买。

   云消息队列 MQTT 版支持的实例类型及功能差异，请参见实例类型。

7. 在确认订单页面，根据提示完成支付。

8. 在支付成功页面单击返回控制台。
9. 回到云消息队列 MQTT 版控制台，在左侧导航栏单击实例列表，并将地域切换为您所购买的实例所对应的地域。
10. 在实例列表页面中，单击您所购买实例的名称或在其操作列单击详情，进入实例详情页面。
11. 在实例详情页面单击接入点页签，即可看到实例的接入点信息，本示例以公网接入点为例。
    

步骤三：创建父级Topic

MQTT协议支持多级Topic，父级Topic需在控制台创建，子级Topic无需创建，使用时直接在代码中设置即可。命名格式为：父级Topic和各子级Topic间均使用正斜线（/）隔开，<父级Topic名称>/<二级Topic名称>/<三级Topic名称>，例如，SendMessage/demo/producer。父级Topic和子级Topic总长度不能超过64个字符。Topic详细信息，请参见名词解释。

1. 登录云消息队列 MQTT 版控制台。
2. 在左侧导航栏单击实例列表。
3. 在顶部菜单栏选择地域。
4. 在实例列表中找到目标实例，在其操作列中，选择更多 > Topic 管理。
5. 在Topic 管理页面左上角，单击创建 Topic。
6. 在创建Topic面板中，输入要创建的Topic名称和描述，然后在左下角单击确定。
   您可以在Topic 管理页面查看刚创建的Topic。

步骤四：创建Group

Group ID详细信息，请参见名词解释。

1. 登录云消息队列 MQTT 版控制台。
2. 在左侧导航栏单击实例列表。
3. 在顶部菜单栏选择地域。
4. 在实例列表中找到目标实例，在其操作列中，选择更多 > Group 管理。
5. 在Group 管理页面的左上角，单击创建 Group。
6. 在创建Group面板中，输入Group ID，然后在左下角单击确定。
   您可以在Group 管理页面查看刚创建的Group。

步骤五：配置MQTT.fx接入云消息队列 MQTT 版

1. 打开MQTT.fx客户端，在其顶部菜单栏中选择Extras > Edit Connection Profiles。

2. 在Edit Connection Profiles页面中配置相关参数，然后单击OK。

   

   参数	说明	取值示例
   Profile Name	配置文件名称。	MQTT Test
   Profile Type	配置的连接类型。	固定选择MQTT Broker，表示连接MQTT服务器。
   MQTT Broker Profile Settings
   Broker Address	步骤二中获取的云消息队列 MQTT 版实例的接入点。	本示例以公网接入点为例。post-cn-st21xgs****.mqtt.aliyuncs.com 说明 post-cn-st21xgs****为您购买的云消息队列 MQTT 版实例ID。
   Broker Port	连接云消息队列 MQTT 版的协议端口。 MQTT协议端口：1883 SSL端口：8883	1883
   Client ID	客户端的唯一标识，要求全局唯一。Client ID由两部分组成，组成形式为<GroupID>@@@<DeviceID>。<GroupID>为步骤四中创建的Group ID，<DeviceID>为您自定义的设备ID。Client ID的长度限制为64个字符，不允许使用不可见字符，具体限制，请参见使用限制。	GID_MQTT_test@@@111 本示例中<DeviceID>自定义为111，<GroupID>为GID_MQTT_test 。
   User Credentials
   User Name	客户端接入云消息队列 MQTT 版需要输入用户名和密码完成认证，认证通过后才能进行消息收发。用户名和密码计算方式请参见签名鉴权模式。	Signature|LTAI4GBY9J8e7YukuUie****|post-cn-st21xgs****
   Password		p3Mxc2PDZet09sHhurTJAg3J****
   SSL/TLS
   Enable SSL/TLS	是否使用SSL或TLS加密协议。	取消选中
   Protocol	协议版本。	TLSv1.2

   说明

   其他参数均使用系统默认值，无需设置。您也可以根据实际场景自定义参数值。

3. 参数配置完成后，单击Connect进行连接。

   • 右侧绿灯亮起，表示MQTT.fx和云消息队列 MQTT 版已成功连接。

   • 右侧红灯亮起，表示连接失败，您可以单击Log查看日志，根据日志信息修改配置并重新尝试连接。

   

   您可以在云消息队列 MQTT 版控制台对应实例下，查看设备状态，预期设备状态为在线。

使用MQTT.fx订阅消息

1. 在MQTT.fx客户端上方单击Subscribe页签。

2. 在Subscribe页签中，在左侧Topic文本框输入步骤三中创建的Topic的名称，然后再单击文本框右侧的Subscribe。本示例以MQTT_test_topic为例。订阅成功后，该Topic会显示在订阅列表中。

   说明

   本文以父级Topic为例，若需要订阅子级Topic，直接在Topic文本框中父级Topic名称后加上子级Topic名称即可，父级Topic和各子级Topic间均使用正斜线（/）隔开，例如MQTT_test_topic/subscribe1。Topic详细信息，请参见名词解释。

   

3. 在云消息队列 MQTT 版控制台对应实例下，单击Topic 管理，找到订阅的Topic，在其操作列单击快速体验。

   

4. 在快速体验消息收发面板中，选择发送方式为控制台并在消息内容文本框中输入要发送的消息内容，例如：hello mqtt，然后单击确定。

   

   回到MQTT.fx客户端，在Subscribe页签中可以查看订阅的Topic接收到的消息。

使用MQTT.fx发送消息

1. 在MQTT.fx客户端上方单击Publish页签。

2. 在Publish页签中，在左侧Topic文本框输入步骤三中创建的Topic的名称，本示例以MQTT_test_topic为例，然后在下面的消息文本框中输入要发送的消息内容，例如：mqtt send message，然后单击Topic文本框右侧的Publish发送消息。

   

   单击Subscribe页签，您可以查看到对应订阅的Topic已接收到刚才发送的消息。

查看消息轨迹

查看日志