设备连接事件

设备连接事件用于通知设备上线或离线。

device.connection.online

设备上线时发送。

{
  "type": "event",
  "topic": "device.connection.online",
  "data": {
    "deviceId": "abc123456789",
    "occurredAt": "2026-04-03T00:41:44Z"
  }
}

device.connection.offline

设备离线时发送。

{
  "type": "event",
  "topic": "device.connection.offline",
  "data": {
    "deviceId": "abc123456789",
    "occurredAt": "2026-04-03T00:41:46Z"
  }
}

data 结构

字段	类型	必填	说明
deviceId	string	是	设备唯一标识
occurredAt	string	是	事件发生时间，RFC3339 UTC

客户端处理

• 上线事件不代表设备全部状态已同步完成
• 离线事件后不应继续认为设备可被控制
• 如需确认当前状态，可调用 REST 查询设备详情