定时存储
ScheduleStore 是基于时间的自动化引擎。它保存重复执行的定时,在特定时间执行设备操作。
功能说明
定时用于自动化日常任务:
- “每天 7:00:开灯”
- “工作日 22:00:锁门”
- “每周一 14:30:给植物浇水”
该存储负责创建、编辑、启用/禁用和删除。同步器负责保持状态同步。
API 参考
属性
| 属性 | 类型 | 用途 |
|---|---|---|
schedulesList | ESPCDFSchedule[] | 全部定时(由内部映射计算得出) |
schedulesByID | Record<string, …> | 用于 O(1) 快速查找的映射 |
获取存储实例
import { initCDF } from "@espressif/rainmaker-base-cdf";
const espCDF = await initCDF({ sdkAdaptorRegistry });
const { scheduleStore } = espCDF;
使用方法
加载定时
const group = espCDF.groupStore.getGroupById("group-id")!;
await group.getSchedules();
// 此时 scheduleStore 已填充
console.log(espCDF.scheduleStore.schedulesList.length);
查询定时
const schedules = espCDF.scheduleStore.schedulesList;
const schedule = espCDF.scheduleStore.getScheduleById("schedule-id");
// 包含指定节点的定时
const forNode = espCDF.scheduleStore.getSchedulesForNode("light-node-id");
创建定时
触发器定义定时何时运行。m 为自午夜起的分钟数;d 为星期位掩码(位 0 表示周日,位 6 表示周六):
const group = espCDF.groupStore.getGroupById("group-id")!;
const rows = await group.getScheduleCapableDevices();
const schedule = await group.createSchedule({
id: "sch-morning",
name: "Morning Routine",
nodes: ["light-node-id"],
triggers: [{ m: 420, d: 127 }], // 每天 07:00
action: {
"light-node-id": { Light: { Power: true, Brightness: 100 } },
},
enabled: true,
});
GroupStoreSynchronizer 会把返回的实体加入 ScheduleStore。
编辑、启用/禁用与删除定时
const schedule = espCDF.scheduleStore.getScheduleById("schedule-id")!;
await schedule.edit({
name: "Updated Routine",
triggers: [{ m: 480, d: 127 }],
action: { "light-node-id": { Light: { Power: true, Brightness: 80 } } },
});
await schedule.enable();
await schedule.disable();
await schedule.remove();
响应式定时列表
import { observer } from "mobx-react-lite";
import type { ESPCDF } from "@espressif/rainmaker-base-cdf";
const ScheduleList = observer(function ScheduleList({
espCDF,
}: {
espCDF: ESPCDF;
}) {
const { scheduleStore } = espCDF;
return (
<FlatList
data={scheduleStore.schedulesList}
keyExtractor={(s) => s.id}
renderItem={({ item }) => (
<View>
<Text>{item.name}</Text>
<Switch
value={item.enabled}
onValueChange={() => (item.enabled ? item.disable() : item.enable())}
/>
</View>
)}
/>
);
});
了解触发器格式
每个触发器指定时间和星期:
m:自午夜起的分钟数(0–1439)d:星期位掩码(位 0 表示周日,位 6 表示周六)
triggers: [
{ m: 420, d: 127 }, // 每天 07:00(0b1111111)
{ m: 1320, d: 62 }, // 周一至周五 22:00(0b0111110)
{ m: 840, d: 1 }, // 仅周日 14:00(0b0000001)
];
// 换算:07:00 = 7 * 60 = 420 分钟
// 每天 = 0b1111111 = 全部 7 天
响应式定时列表
import { observer } from "mobx-react-lite";
import type { ESPCDF } from "@espressif/rainmaker-base-cdf";
const ScheduleList = observer(function ScheduleList({
espCDF,
}: {
espCDF: ESPCDF;
}) {
const schedules = espCDF.scheduleStore.schedulesList;
return (
<FlatList
data={schedules}
keyExtractor={(s) => s.id}
renderItem={({ item }) => (
<View>
<Text>{item.name}</Text>
<Switch
value={item.enabled}
onValueChange={() => (item.enabled ? item.disable() : item.enable())}
/>
</View>
)}
/>
);
});
另请参阅
实现
API 参考

