订阅存储
SubscriptionStore 是 CDF 的实时事件网关。它把 RainMaker SDK 的推送事件(云端更新、本地发现)接到应用内可观察的节点状态上。
功能说明
当云端发来设备更新,或发现本地传输时,SubscriptionStore 通过两个入口接收:
nodeUpdates.listen(event)— 处理参数变更、连接状态更新和用户-节点操作transport.listen(config)— 注册新的本地传输(Wi-Fi、BLE、Thread 等)
这些监听器把事件交给 nodeEventHandlers,由后者更新 NodeStore 中的可观察对象。界面组件通过 observer() 观察这些可观察对象,并自动重新渲染。
不要直接调用 SDK 来获取更新。 适配器负责订阅生命周期,并把 SDK 回调接到这些监听器。这样可以保证单一数据来源,也便于追踪事件流向。
事件流
分步说明:
- 云端推送 — RainMaker 后端发送设备更新
- 订阅 — 适配器通过
ESPCDFUser.subscribeToNodeUpdates()注册回调 - 监听 — 回调把事件转发给
subscriptionStore.nodeUpdates.listen() - 处理 — 事件处理函数处理有效载荷(参数、连接状态、用户-节点变更)
- 获取节点 — 处理函数在
NodeStore中查找节点 - 更新 — 处理函数通过
@action更新可观察属性 - 界面更新 — 使用
observer()的组件自动重新渲染
API 参考
nodeUpdates.listen(event)
接收来自 SDK 的节点更新事件,并路由到事件处理函数。
espCDF.subscriptionStore.nodeUpdates.listen({
nodeId: "abc123",
event_type: "params_updated",
params: { power: "on", brightness: 80 }
});
transport.listen({ nodeId, transportDetails })
为节点注册新发现的本地传输(Wi-Fi、BLE、Thread 等)。
espCDF.subscriptionStore.transport.listen({
nodeId: "abc123",
transportDetails: { type: "local", host: "192.168.1.10", port: 80 }
});
说明: 此存储不管理订阅生命周期(startNodeUpdates、stopNodeUpdates)。该职责属于适配器和 ESPCDFUser。

