子设备上下线
子设备的上下线需要网关代理上报。
网关可逐个或批量上报子设备的在线状态。在上报子设备在线状态之前,需要建立网关和子设备的拓扑关系。网关上报子设备在线状态时,云端会校验网关和子设备的拓扑关系,并进行身份验证,确定网关是否有权代理子设备上下线。
提示
- 网关代理子设备上报在线状态之前,需要建立网关和子设备的拓扑关系。
- 子设备批量上下线是异步的操作,云端无响应。
子设备上线
在建立拓扑关系的前提下,网关可以代理子设备上线。
设备发送消息
topic:things/up/${tenantId}/${productKey}/${deviceKey}/sub/login
json
{
"msgId":"45lkj3551234001",
"time":1626197189600,
"data":[
{
"product":"a123b456****",
"device":"123455asdf****"
},
{
"product":"a123b457****",
"device":"453455asdf****"
}
]
}
参数说明
类型 | 说明 | 必选 | 备注 |
---|---|---|---|
${productKey} | 产品 Key | 是 | 子设备所属产品的 ProductKey。 |
${deviceKey} | 设备 Key | 是 | 子设备所属产品的 DeviceKey。 |
version | 协议版本 | 否 | 默认 1.0,仅有 1.0。 |
msgId | 消息 ID | 是 | 总长度不超过 32 位的字符,请求和响应消息通过该值建立应答关系。 |
time | 消息时间戳 | 是 | 消息发送时的 Unix 时间戳,10 位秒级或 13 位毫秒级。 |
data | 上线的子设备列表 | 是 | 子设备的列表,设备数量不超过 100。 |
data[].product | String | 子设备的产品 Key | 是 |
data[].device | String | 子设备的设备 Key | 是 |
子设备下线
在建立拓扑关系的前提下,网关可以代理子设备下线。
设备发送消息
topic:things/up/${tenantId}/${productKey}/${deviceKey}/sub/logout
json
{
"msgId":"45lkj3551234001",
"time":1626197189600,
"data":[
{
"product":"a123b456****",
"device":"123455asdf****"
},
{
"product":"a123b457****",
"device":"453455asdf****"
}
]
}
参数说明
类型 | 说明 | 必选 | 备注 |
---|---|---|---|
${productKey} | 产品 Key | 是 | 子设备所属产品的 ProductKey。 |
${deviceKey} | 设备 Key | 是 | 子设备所属产品的 DeviceKey。 |
version | 协议版本 | 否 | 默认 1.0,仅有 1.0。 |
msgId | 消息 ID | 是 | 总长度不超过 32 位的字符,请求和响应消息通过该值建立应答关系。 |
time | 消息时间戳 | 是 | 消息发送时的 Unix 时间戳,10 位秒级或 13 位毫秒级。 |
data | 下线的子设备列表 | 是 | 多个子设备的列表,设备数量不超过 100。 |
data[].product | String | 子设备的产品 Key | 是 |
data[].device | String | 子设备的设备 Key | 是 |