跳到主要内容

定时存储

ScheduleStore 是基于时间的自动化引擎。它保存重复执行的定时,在特定时间执行设备操作。

功能说明​

定时用于自动化日常任务:

  • “每天 7:00:开灯”
  • “工作日 22:00:锁门”
  • “每周一 14:30:给植物浇水”

该存储负责创建、编辑、启用/禁用和删除。同步器负责保持状态同步。

API 参考​

属性​

属性类型用途
schedulesListESPCDFSchedule[]全部定时(由内部映射计算得出)
schedulesByIDRecord<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 参考

On this page