Skip to content

子设备上下线

子设备的上下线需要网关代理上报。

网关可逐个或批量上报子设备的在线状态。在上报子设备在线状态之前,需要建立网关和子设备的拓扑关系。网关上报子设备在线状态时,云端会校验网关和子设备的拓扑关系,并进行身份验证,确定网关是否有权代理子设备上下线。

提示

  • 网关代理子设备上报在线状态之前,需要建立网关和子设备的拓扑关系。
  • 子设备批量上下线是异步的操作,云端无响应。

子设备上线

在建立拓扑关系的前提下,网关可以代理子设备上线。

设备发送消息

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[].productString子设备的产品 Key
data[].deviceString子设备的设备 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[].productString子设备的产品 Key
data[].deviceString子设备的设备 Key