MQTT协议规范

支持版本

目前物联网平台支持MQTT标准协议接入，兼容5.0、3.1.1和3.1版本协议，具体的协议请参见MQTT 5.0、MQTT 3.1.1和 MQTT 3.1协议文档。

与标准MQTT的区别

• 支持MQTT的PUB、SUB、PING、PONG、CONNECT、DISCONNECT和UNSUB等报文。
• 支持clean session。
• 不支持will、retain msg。
• 支持QoS 0、QoS 1，不支持QoS 2。
• 不支持SUB QoS，消息QoS以发送方（PUB）指定为准。
• 基于原生的MQTT Topic上支持RRPC同步模式，服务器可以同步调用设备并获取设备回执结果。

支持的MQTT 5.0特性

MQTT 5.0协议在之前版本基础上添加了大量全新特性，提高了性能和易用性。更多信息，请参见Appendix C. Summary of new features in MQTT v5.0。

目前，物联网平台支持MQTT 5.0的部分新增特性。

• 支持设置客户端和服务端发送报文的最大长度，直接过滤冗长的消息。

  MqttConnectionOptions connOpts = new MqttConnectionOptions();
  connOpts.setMaximumPacketSize(1024L);

• 支持设置QoS 1消息限流值，单位为条/秒。

  MqttConnectionOptions connOpts = new MqttConnectionOptions();
  connOpts.setReceiveMaximum(5);

• 支持设置UserProperty属性列表，每个属性由Key和Value组成，用于传输额外的属性数据。
  说明 最多可添加20个属性。属性中Key值不允许以下划线（_）开头，Key和Value最大总长度不超过128个字符。

  MqttProperties properties = new MqttProperties();
  List<UserProperty> userPropertys = new ArrayList<>();
  userPropertys.add(new UserProperty("key1","value1"));
  properties.setUserProperties(userPropertys);

  设备使用MQTT 5.0协议成功接入物联网平台后，可在云端运行日志内容中，查看到上报的UserProperty数据。

• 新增了响应主题（ResponseTopic）和相关数据（CorrelationData），类似HTTP请求响应的模式，实现双方通信。

  例如，请求方为设备，接收方为您的业务服务器，您可通过AMQP订阅或规则流转后，从消息的属性列表中解析出ResponseTopic和CorrelationData，然后调用Pub接口，将响应发送给设备。

  MqttProperties properties = new MqttProperties();
  properties.setCorrelationData("requestId12345".getBytes());
  properties.setResponseTopic("/" + productKey + "/" + deviceName + "/user/get");

  说明

  • 解析出的CorrelationData， 需要通过Base64解码，才能还原成设备上报的byte数组类型数据。
  • ResponseTopic和CorrelationData的最大长度都不能超过128个字符。
• 增加了更多返回码，便于设备快速定位请求状态及问题。

  更多信息，请参见错误排查。

• 支持将消息通信Topic缩小为整型数值，来减小MQTT报文，节约网络带宽资源。

安全等级

• TCP通道TLS直连模式：安全级别高。
  说明

  • 支持TLS协议1.0、1.1和1.2版本，强烈建议您的设备使用TLS 1.2加密。因TLS 1.0、1.1版本较老，可能有安全风险。
  • 设备端Link SDK已配置V1.2版本的TLS协议，您无需自行配置。
• TCP直连模式，并使用芯片级加密（ID²硬件集成）：安全级别高。
• TCP直连模式（数据不加密）：不安全，功能即将下线，请勿使用。

Topic规范

Topic定义及分类，请查看什么是Topic。

系统默认通信类Topic可前往控制台设备详情页查看，功能类Topic可前往具体功能文档页查看。

使用限制

设备身份注册成功后，针对同一设备身份信息，只可选择一种通信协议接入物联网平台，不可多种类型通信协议同时混用。

使用说明

物联网平台提供各类设备端SDK，支持设备使用MQTT协议接入物联网平台。获取SDK方法，请参见下载设备端SDK。

设备基于MQTT协议通过不同方式接入物联网平台进行通信的配置说明，请参见：

• MQTT-TCP连接通信。
• 基于MQTT通道的设备动态注册。
• MQTT-WebSocket连接通信。
• 基于IPv6的MQTT连接通信。