设备状态上报与同步

设备状态有三条同步路径：

路径 1：小程序主动轮询（hapi REST）

flowchart LR
    A["小程序"] --> B["hapi POST /room/status"]
    B --> C["Redis"]
    C --> A

路径 2：hapi Webhook 推送（第三方应用）

flowchart LR
    A["网关"] --> B["MQTT ble_out"]
    B --> C["hapi"]
    C --> D["Webhook"]
    D --> E["第三方应用"]

路径 3：ztUtil SDK 实时回调（小程序本地）

flowchart LR
    A["网关"] --> B["MQTT ble_out"]
    B --> C["ztUtil MqttLayer"]
    C --> D["register callback code=2000"]
    D --> E["小程序更新 buttons_state"]

ztUtil 状态推送回调

小程序通过 ysUtil.register(callback) 注册后，设备状态变化会实时推送到回调函数：

ysUtil.register(res => {
  if (res.code === 2000) {
    // res.data.naddr — 设备网络地址
    // res.data.status — 状态数据（开关/亮度/色温等）
  }
  if (res.code === -2000) {
    // res.data.naddr — 离线设备
    // res.data.offline — 离线状态
  }
})

三条路径对比

对比项	路径 1（轮询）	路径 2（Webhook）	路径 3（ztUtil 回调）
实时性	低（依赖轮询间隔）	中（Webhook 延迟）	高（MQTT 实时推送）
适用方	小程序	第三方应用	小程序
认证	JWT	Webhook 签名	MQTT mq_id
状态来源	Redis 缓存	hapi 解析后转发	ztUtil 直接解析 ble_out