共享桌游室灯光空调控制：怎么将DC-10A 定时控制开关对接到自己的项目中_解决方案

CATALOG

芯步DC-10A的核心优势是HTTP接口——这意味着无论你用小程序、App还是管理后台，都可以通过几行代码直接控制设备，无需复杂的网关配置。下面从对接流程、代码示例到完整业务逻辑，梳理接入方案。

解决方案：基于芯步 DC-10A 的共享桌游室智能光空控制方案

一、背景与选型依据

在共享桌游室、棋牌室或自习室的无人值守场景中，空调和灯光是能耗大户。传统的改造方案往往依赖 Zigbee 网关或复杂的接线，而 芯步 DC-10A 智能通断器 提供了一个极其轻量化的解决方案。

为什么不选其他方案？

对比 Zigbee/蓝牙 Mesh：传统方案需要额外购买网关，增加了硬件成本和故障点。
对比 4G 插排：资费高，且体积庞大。

DC-10A 的核心优势：

直接联网：使用 WiFi 2.4G 直连，内置信号增强算法（可设定5组WiFi自动切换），彻底抛弃网关。
极简 API：仅需 HTTP 请求即可控制，完美适配微信小程序、Web 管理后台或手机 APP。
成本低廉：作为通断器，可以直接隐藏在桌游室的吊顶灯带内、空调插座底盒内，实现无损改造。

二、对接架构图

本方案采用 云-云 或 端-云 的直连模式：

flowchart LR
    subgraph A [用户端]
        User[用户手机小程序] --> WeChat[微信支付/登录]
    end

    subgraph B [服务端]
        Cloud[共享桌游 SaaS 系统
你的业务服务器]
    end

    subgraph C [设备层]
        API[芯步开放 API]
        Device1[DC-10A 通断器
桌游台灯控]
        Device2[DC-10A 通断器
空调/新风控制]
    end

    User -- "下单/续费" --> Cloud
    Cloud -- "1. 订单开始/结束事件
2. HTTP 调用接口" --> API
    API -- "MQTT/长连接推送" --> Device1
    API -- "MQTT/长连接推送" --> Device2

三、详细对接步骤

1. 环境准备：获取密钥与设备ID

在开始写代码前，需要先在芯步控制台完成基础配置：

获取凭证：登录芯步工作台，获取 AppID 和 AppSecret。这是你调用 API 的“身份证”。
设备配网
- 将 DC-10A 通电。
- 使用官方 App 或小程序，通过“ SmartConfig ”或“ AP 配网 ”将设备连接到桌游室的 WiFi。
- 关键点：记录下分配给你的 device_id （通常是纯数字格式），这是你控制目标对象的“门牌号”。

2. 签名机制与接口封装

为了保证安全性，芯步的 HTTP 接口通常需要携带签名。你需要在后端封装一个统一的设备控制函数。

核心逻辑（PHP/Node.js/Python 通用伪代码思路）：你需要构造一个 HTTP POST 请求，必须包含以下参数：

device_id ：你要控制的那个 DC-10A 的 ID。
command ：具体的指令，例如 {"power": "on"}。
sign ：根据 AppSecret 和当前时间戳 ts 生成的 MD5 签名，防止接口被恶意调用。
ts ：当前 UNIX 时间戳。

参考接口调用逻辑：根据开发文档，只要签名正确且设备在线，下发命令即可生效。

3. 核心代码实现：定时与联动逻辑

在共享桌游场景中，最核心的需求是“订单支付成功即通电，订单结束自动断电”。以下是针对这个业务逻辑的具体实现方案：

场景控制矩阵：

业务事件	执行动作 (DC-10A)	说明
用户下单/开门	闭合 (通电)	开启对应桌位的射灯、氛围灯、预留空调插座
倒计时提醒	无操作 / 语音播报	仅推送微信模板消息，或利用 DC-10A 蜂鸣器提示
时间到 / 超时	断开 (断电)	切断灯光，空调自动关闭，桌游台面复位
手动续费	维持通电 (重置计时器)	服务器收到支付回调，保持闭合状态

后端处理逻辑流程：

用户支付成功
- 你的业务系统收到微信支付回调，订单状态变为“进行中”。
- 系统计算使用时长，写入数据库。
下发开灯命令
- 你的后端发起 HTTP 请求：
  - URL: https://api.yoyoiot.com/ordercontrol
  - Body: {"device_id": "123456", "status": "on"}
- DC-10A 吸合，灯亮，空调启动。
定时关闭任务
- 你的后端在 Redis 或内存中设置一个定时器（例如 2 小时后）。
- 执行关闭：时间到达，调用接口下发 "status": "off"。
- 防呆机制：由于网络波动，可设置二次校验。在后端记录状态，若 23:00 后设备状态仍为 ON，再次发送关闭指令。

4. 针对“空调”控制的特别优化

注意：空调不同于普通灯光。普通灯光断电即灭；空调如果直接断电，会失去压缩机保护机制，且再次来电时可能处于待机状态而非运行状态。

推荐方案（红外+通断结合）：

如果你控制的是普通电风扇或非智能取暖器：直接使用 DC-10A 串联在插座中即可。
如果你控制的是壁挂式空调：单纯通断无法直接启动，因为空调需要红外指令。
- 解决路径：使用芯步生态中的 “空调伴侣” 或 “红外转发器”。
- 逻辑对接：当订单开始时，你的服务器先调用“红外转发器”的 API 发送“制冷、26度”指令，再调用 DC-10A 确认供电。如果担心空调待机耗电，可在订单结束后利用 DC-10A 彻底断电。

四、集成到你的桌游 SaaS 系统（前后端交互）

假设你正在开发一个小程序，用户界面需要实时显示设备状态。

1. 获取设备状态

调用芯步的 设备状态查询 API，获取当前 DC-10A 是 ON 还是 OFF。
展示：在小程序首页的“3号桌游间”卡片上，显示一个动态的“灯光状态”指示灯。

2. 用户手动干预

场景：用户觉得太冷，想关空调，但又不想结束订单。
实现：小程序点击“关闭空调” -> 调用云函数 -> 云函数携带 AppSecret 签名 -> 请求芯步 API -> DC-10A 断开。

3. 异常处理

设备离线：你的后端在调用 API 后，如果返回 offline 错误码，应立即通过短信或客服系统通知管理员检查桌游室的 WiFi 路由器（DC-10A 对 WiFi 稳定性依赖较大）。
防误关：在订单进行中，除非用户主动点击，否则不要因为定时任务的误差错误切断电源。设定 “提前5分钟提醒，到点才断电” 的策略。