2.3. 客户端订阅请求 SUBCRIBE
### 2.3.1. 云交换机方式订阅 ### **2.3.1.1. 订阅单台设备数据流** APP 订阅单台设备,设备实时数据流将推送给 APP。 主题为“$USR/DevTx/<Id>”(<Id>为要接收的目标设备Id)。 例:订阅 ID 为 123 的设备实时推送的数据,主题为:$USR/DevTx/123 <table ><tr style="background-color:#127fc4; color: #fff;"><td >类型 </td><td>长度</td><td>数据</td><td>说明</td></tr><tr><td rowspan="2">固定报头</td><td>1Byte</td><td>0x82</td><td>固定报头(1000 0010)</td></tr><tr><td>1Byte</td><td>0x13 </td><td>剩余长度:19Byte</td></tr><tr><td>可变报头</td><td>2Byte</td><td>0x00<br>0x0A</td><td>报文标识符:10</td></tr><tr><td rowspan="3">有效载荷</td><td>2Byte</td><td>0x00<br>0x0E</td><td>主题过滤器长度:14Byte</td></tr><tr><td>14Byte</td><td>0x24<br>0x55<br>0x53<br>0x52<br>0x2F<br>0x44<br>Ox65<br>0x76<br>0x54<br>0x78<br>0x2F<br>0x31<br>0x32<br>0x33</td><td>主题过滤器长度:14Byte</td></tr><tr><td>1Byte</td><td>0x00</td><td>服务质量要求:0</td></tr></table> ### 2.3.1.2. 订阅账号下全部设备数据流 APP 订阅帐号下全部设备,设备实时数据流将推送给 APP。 主题为“$USR/Dev2App/<帐号>/+”(<帐号>为登录帐号,支持订阅子账号),接收设备 PUBLISH 时,+替换为设备 Id。 订阅协议格式同 2.3.1 订阅单台设备数据流 例:订阅 abc 帐号下全部设备实时推送的数据,主题为:$USR/Dev2App/abc/+; 当 ID 为 123 的设备发送数据流时,PUBLISH 的主题为:$USR/Dev2App/abc/123 ### 2.3.2.1. 订阅单台设备 JSON 前提:设备发送数据流为透传云支持的协议,并在透传云后台添加协议对应的数据点。 透传云将按照协议设置解析数据流,并以 JSON 格式 PUBLISH 给此主题。 主题为:“$USR/DevJsonTx/<Id>”(<Id>为设备 Id) 订阅协议格式同 2.3.1 订阅单台设备数据流。 例:订阅 ID 为 123 的设备,接收解析完成的指令,主题为:$USR/DevJsonTx/123 注:订阅后,设备发送数据时, APP 将收到服务器 PUBLISH 的消息,有效载荷为 JSON 格式字符串,协议格式解释见: 3.JSON 协议数据格式 ### 2.3.2.2. 订阅账号下全部设备 JSON 前提:设备发送数据流为透传云支持的协议,并在透传云后台添加协议对应的数据点。 透传云将按照协议设置解析数据流,并以 JSON 格式 PUBLISH 给此主题。 主题为“$USR/AllDevJsonTx/<帐号>/+”(<帐号>为登录帐号,支持订阅子账号),接收设备 PUBLISH 时,+替换为设备 Id。 订阅协议格式同 2.3.1 订阅单台设备数据流。 例:订阅 abc 帐号下全部设备的JSON数据,主题为:$USR/AllDevJsonTx/abc/+ 当 ID 为 123 的设备发送数据流时,PUBLISH 的主题为:$USR/AllDevJsonTx/abc/123 注:订阅后,设备发送数据时, APP 将收到服务器 PUBLISH 的消息,有效载荷为 JSON 格式字符串,协议格式解释见: 3.JSON 协议数据格式 ### 2.3.2.3. 订阅帐号下全部设备监控状态 帐号下全部设备的上线下状态变化和后台对数据点设定有报警规则,透传云将以 JSON 格式 PUBLISH 给此主题。 主题为:“$USR/JsonTx/<帐号>/+”(<帐号>为登录帐号,支持订阅子账号),接收 PUBLISH 时,+替换为设备 Id。 订阅协议格式同 2.3.1 订阅单台设备数据流。 例:订阅 abc 帐号下全部设备在线状态变化和报警信息,主题为:$USR/JsonTx/abc/+; 当 ID 为 123 的设备在线状态变化和报警信息时,PUBLISH 的主题为:$USR/JsonTx/abc/123 注:订阅后,设备上下线或触发报警时, APP 将收到服务器 PUBLISH 的消息,有效载荷为 JSON 格式字符串, 协议格式解释见: 3.JSON 协议数据格式