MQTT客户端接入说明
在调用创建规则触发条件、创建规则动作和修改规则触发条件配置并激活规则后,您需要参考本文将MQTT客户端接入物联网平台,成功接入后,在您的服务端运行MQTT客户端,即可接收订阅的消息。
连接配置说明
MQTT客户端接入物联网平台的连接地址和连接认证参数说明如下:
- MQTT接入域名
每个账号会自动生成,请前往管理控制台-接入信息页面获取。
图1 接入信息-应用侧MQTT接入地址
- 端口:8883
- 客户端身份认证参数
clientId:全局唯一即可,建议使用“username”。
username =“accessKey=${accessKey}|timestamp=${timestamp}|instanceId=${instanceId}”
password =“${accessCode}”
参数
是否必须
说明
${accessKey}
是
接入凭证键值,单个键值最多允许10个客户端同时进行建链。 首次建链时候,请参考获取AMQP接入凭证进行预置。
${timestamp}
否
客户端传递当前时间的13位毫秒级时间戳。
如果传递该参数,服务端会校验该时间戳与服务器时间的差值,若超过5分钟则视为无效请求。
instanceId
否
实例Id,同一Region购买多个标准版实例时需要填设置该参数,实例Id参考这里查看实例获取。
${accessCode}
是
接入凭证密钥,长度不超过256个。
获取MQTT接入凭证
若应用使用MQTT协议接入物联网平台进行数据流转需要使用接入凭证,首次使用或者忘记接入凭证请先预置接入凭证。您可以通过调用生成接入凭证接口预置,也可以前往控制台页面进行预置,详细方法请参考如下操作:
- 访问设备接入服务,单击“管理控制台”进入设备接入控制台。选择您的实例,单击实例卡片进入。
- 选择进入“规则列表”页面。 图2 规则详情-数据转发规则
- 单击“详情”(如果没有规则请先创建规则)进入规则详情页面后切换到“设置转发目标”。 图3 转发目标-进入设置转发目标
- 单击“添加”进入添加转发目标页面,设置转发目标为“MQTT推送消息队列”,单击“预置服务接入凭证”预置接入凭证密钥(access_code)和接入凭证键值(access_key)。 图4 新建转发目标-转发至MQTT推送消息队列预置凭证
如果您之前预置过接入凭证,重新预置之后,之前的接入凭证密钥将不能再使用。
接收平台推送的消息
客户端和平台之间建链成功后,订阅数据流转规则中MQTT通道中的Topic,设备上报数据后触发流转规则,平台就会把流转数据推送至MQTT客户端。