更新时间:2024-08-21 GMT+08:00

MQTT客户端接入说明

在调用创建规则触发条件创建规则动作修改规则触发条件配置并激活规则后,您需要参考本文将MQTT客户端接入物联网平台,成功接入后,在您的服务端运行MQTT客户端,即可接收订阅的消息。

连接配置说明

MQTT客户端接入物联网平台的连接地址和连接认证参数说明如下:

  • MQTT接入域名

    每个账号会自动生成,请前往控制台-接入信息页面获取。

    图1 接入信息-应用侧MQTT接入地址
  • 端口:8883
  • 客户端身份认证参数

    clientId:全局唯一即可,建议使用“username”

    username =“accessKey=${accessKey}|timestamp=${timestamp}|instanceId=${instanceId}”

    password =“${accessCode}”

    参数

    是否必须

    说明

    ${accessKey}

    接入凭证键值,单个键值最多允许10个客户端同时进行建链。 首次建链时候,请参考这里进行预置。

    ${timestamp}

    表示当前时间,13位毫秒值时间戳。服务端校验客户端的时间戳,且时间戳相差5分钟。

    instanceId

    实例Id,同一Region购买多个标准版实例时需要填设置该参数,实例Id参考这里这里获取。

    ${accessCode}

    接入凭证密钥,长度不超过256个。

获取MQTT接入凭证

若应用使用MQTT协议接入物联网平台进行数据流转需要使用接入凭证,首次使用或者忘记接入凭证请先预置接入凭证。您可以通过调用生成接入凭证接口预置,也可以前往控制台页面进行预置,详细方法请参考如下操作:

  1. 访问设备接入服务,单击“管理控制台”进入设备接入控制台。选择您的实例,单击实例卡片进入。
  2. 选择规则>数据转发进入“规则列表”页面。

    图2 规则详情-数据转发规则

  3. 单击"详情"(如果没有规则请先创建规则)进入规则详情页面后切换到"设置转发目标"页签。

    图3 转发目标-进入设置转发目标

  4. 单击"添加"进入"添加转发目标"页面,设置转发目标为"MQTT推送消息队列",单击“预置服务接入凭证”预置接入凭证密钥(access_code)和接入凭证键值(access_key)。

    图4 新建转发目标-转发至MQTT推送消息队列预置凭证

    如果您之前预置过接入凭证,重新预置之后,之前的接入凭证密钥将不能再使用。

接收平台推送的消息

客户端和平台之间建链成功后,订阅数据流转规则中MQTT通道中的Topic,设备上报数据后触发流转规则,平台就会把流转数据推送至MQTT客户端。