共享茶室的痛点在于：用户离开现场时后插座/照明未关导致能耗损失，而保洁人员到场前灯光又需要提前开启。芯步的智能控制器和开放接口恰好能解决这类“定时+远程”的双向控制需求。以下方案聚焦于如何通过HTTP接口将定时任务系统与硬件设备对接。

1. 背景与需求分析

在共享茶室、共享自习室或共享台球室等无人值守业态中，运营方普遍面临以下痛点：

• 能耗浪费：用户离开现场时后，空调、照明或插座未及时关闭，导致电力空耗。

• 体验与成本矛盾：用户希望进入茶室时灯光已亮起、插座已通电，营造舒适环境，但若24小时通电不仅危险且浪费。

• 人工干预滞后：依赖保洁或运营人员手动操作不现实，尤其在多门店情况下。

针对上述问题，结合 芯步（ThingBoot） 的智能硬件产品及开放 API 接口，设计一套“远程定时任务控制系统”，实现对茶室内的照明和插座回路进行精准的定时断/通电管理。

2. 解决方案设计

本方案采用 “云+端” 的轻量化架构，利用共享茶室现有的网络环境（Wi-Fi），无需额外部署网关。

2.1 硬件层

选用 芯步智能控制器（如8路或4路版本）。该设备直接接入茶室配电箱，替代传统空气开关或继电器模组：

• 强电接入：输入端接入 220V 市电，输出端直接控制对应线路（如：“靠窗射灯”、“茶台插座”、“空调插座”、“氛围灯带”）。

• 通讯层：设备通过 2.4GHz Wi-Fi 连接至茶室路由器，与芯步云保持长连接。

2.2 业务逻辑层

• 芯步开放平台：负责设备状态维持与指令转发。

• SaaS 业务端：通过调用芯步的 HTTP API 接口，将控制逻辑集成进现有的共享茶室管理系统中。

2.3 控制终端

• 用户小程序：用户下单后自动触发授权与通电。

• 商家管理后台：配置定时策略（如：每天 23:00 全店断电）。

3. 核心功能实现：定时任务与远程控制

本方案的核心在于利用芯步极其简洁的 HTTP API 实现“定时任务”的闭环。

3.1 设备对接流程

1. 设备激活：智能控制器上电后配网，在芯步控制台中获取唯一的 Device ID（如：820720）和 AppId。

2. 接口鉴权：调用 http(s)://api.thingboot.com/{AppId}/device/control/，携带 sign（签名）和 ts（时间戳）进行身份验证。

3.2 “定时任务”指令下发逻辑

在共享茶室场景中，定时任务分为“一次性定时”（用户订单关联）和“周期性定时”（门店运营策略）。SaaS 后端需维护一个定时任务队列（Quartz 或 Cron Jobs），时间到达时触发芯步接口。

场景 A：预约订单的预开电（体验优化）

• 需求：用户通过小程序预订了 14:00-17:00 的包间，希望 14:00 进入时灯已亮。

• 实现逻辑

  1. 用户支付成功后，SaaS 系统记录订单开始时间 14:00。

  2. 系统设置一个定时任务（Delay Task）。

  3. 当服务器时间到达 13:59:30（提前30秒），SaaS 后端调用芯步接口。

  4. API 调用示例

     • 请求地址：http://api.thingboot.com/YourAppId/device/control/?sign=xxxx&ts=1712345678

     • Method：POST

     • JSON 报文：

       { "device": 820720, // 对应茶室的8路控制器 "order": { "power1": 1, // 打开第1路灯（照明） "power2": 1, // 打开第2路插座（茶炉电源） "power7": 1 // 打开第7路（氛围灯） } }

  5. 结果：用户刷卡或输入密码开门时，室内已处于明亮通电状态。

场景 B：订单结束的自动断电（能耗管控）

• 需求：17:00 订单结束，如用户未续费，需强制断电。

• 实现逻辑

  1. 订单倒计时归零，SaaS 校验未续费。

  2. 后端调用接口，将对应 power 字段设为 0。

  3. 进阶保障：除了云端定时，可结合人体传感器逻辑。若订单结束且传感器检测“无人”持续 5 分钟，再次下发断电指令，双重保险。

场景 C：周期性定时任务（运营策略）

• 需求：每天晚上 23:00 至次日 8:00，关闭所有非监控设备电源；保洁阿姨每日 8:30 入场清洁时需要照明。

• 实现逻辑

  1. 运营人员在后台设置“日清策略”。

  2. 系统每日 23:00 执行：

     { "device": 820720, "order": { "power1": 0, "power2": 0, "power3": 0, "power4": 0 } }

  3. 系统每日 8:30 执行：

     { "device": 820720, "order": { "power1": 1 } } // 仅开启保洁照明回路，插座不开，安全节能

  4. 芯步设备支持实时状态上报，SaaS 可记录每次开关日志，用于统计设备故障率。

3.3 异常处理与状态同步

芯步的接口响应速度极快（约 80-120ms），但在弱网环境下可能丢包。

• 重试机制：SaaS 端调用接口若超时，应自动重试 3 次。

• 状态查询：若存疑，可调用查询接口获取设备当前真实状态，防止“指令下发成功但设备实际掉线”导致的口碑纠纷。

• 本地联动：利用芯步传感器（如人体存在雷达），当检测到房间无人且订单结束超过 10 分钟时，执行断电保护。

4. 方案实施步骤

第一阶段：硬件选型与布线

1. 采购设备：根据茶室回路数量，选择芯步 8路智能控制器（UNI-KZQ-AC-8）或 4路版本。

2. 强电改造：由电工将设备串联在总闸之后。将“照明”、“普通插座”、“空调”等不同回路分别接入控制器的对应输出端子。

3. 网络覆盖：确保茶室内 Wi-Fi 信号覆盖配电箱位置（2.4GHz 频段）。

第二阶段：开发与集成

1. 注册开发者：在芯步开放平台（ThingBoot Open）完成企业认证，获取 API Key/Secret。

2. 集成接口

   • 在后端代码中封装芯步的 Device Control 工具类。

   • 实现签名生成算法（Sign）。

   • 建立定时任务数据库表（字段：设备ID、回路号、执行时间、开关状态）。

3. 回调配置：配置消息推送 URL，接收设备上报的状态变更（如：本地物理按键按下了开关，需同步到云端订单计费状态）。

第三阶段：联调与上线

1. 沙箱测试：在测试环境模拟订单创建、订单结束、异常断电等场景，调用真实接口测试 8 路继电器的吸合响应。

2. 灰度发布：先开放一个试点茶室，观察一周的控制稳定性。

5. 业务价值总结

• 降本增效：通过自动化定时任务，无需人工巡场断电。以 10 间茶室为例，每月可节省电费约 30% 以上，同时延长灯具与插座的使用寿命。

• 用户体验升级：用户预订后即享“人到灯亮、插座有电”的零等待体验，配合芯步传感器，甚至可实现人来灯亮、人走灯灭的进一步智能化升级。

• 开放性保障：芯步基于标准 HTTP 协议，不受编程语言限制，可轻松集成到现有的 Java、Python、PHP 或 Node.js 后台架构中，无需定制硬件。

通过上述方案，共享茶室运营者能够利用芯步的开放能力，以较低的成本快速构建一套稳定、智能的无人值守电力管控系统。