物联网之MQTT3.1.1和MQTT5协议 (12) UNSUBACK 报文

前言

服务端发送UNSUBACK报文给客户端用于确认收到UNSUBSCRIBE报文。

UNSUBACK – 取消订阅确认

固定报头

剩余长度字段
等于可变报头的长度加上有效载荷的长度，编码为变长字节整数。

MQTT3.1.1中可变报头的长度等于2字节

可变报头

UNSUBACK报文可变报头按顺序包含以下字段：所确认的UNSUBSCRIBE报文标识符和属性( Properties)。

MQTT3.1.1没有属性概念

UNSUBACK属性

属性长度

UNSUBACK报文可变报头中的属性的长度被编码为变长字节整数。

原因字符串

31 (0x1F)Byte，原因字符串(Reason String)标识符。
跟随其后的是UTF-8编码的字符串，表示此次响应相关的原因。此原因字符串(Reason String)是为诊断而设计的可读字符串，不应该被客户端所解析。

服务端使用此值向客户端提供附加信息。如果加上原因字符串之后的UNSUBACK报文长度超出了客户端指定的最大报文长度，则服务端不能发送此原因字符串。包含多个原因字符串将造成协议错误(Protocol Error)。

用户属性

38 (0x26)Byte，用户属性(User Property)标识符。

跟随其后的是UTF-8字符串键值对。

此属性可用于向客户端提供包括诊断信息在内的附加信息。如果加上用户属性之后的UNSUBACK报文长度超出了客户端指定的最大报文长度，则服务端不能发送此属性。用户属性(User Property)允许出现多次，以表示多个名字/值对，且相同的名字可以多次出现。

UNSUBACK载荷(MQTT5有载荷)

MQTT3.1.1 UNSUBACK报文没有有效载荷。

有效载荷包含一个原因码列表。每个原因码对应UNSUBSCRIBE报文中的一个被确认的主题过滤器。UNSUBACK报文中的原因码顺序必须与UNSUBSCRIBE报文中的主题过滤器顺序相匹配。

单字节无符号取消订阅原因码的值如下所示。服务端发送UNSUBACK报文时对于每个收到的主题过滤器，必须使用一个取消订阅原因码。

取消订阅原因码

对于UNSUBSCRIBE报文中的每个主题过滤器，总有一个对应的原因码。如果原因码不是针对某个特定的主题过滤器(比如0x91(报文标识符已占用))，则对每个主题过滤器都使用此原因码。