共享棋牌室的照明定时控制，核心在于将订单系统与硬件指令打通——订单开始前自动通电，结束后延时断电。以下方案基于芯步智能包间控制器的开放接口，说明如何通过HTTP API实现这一闭环控制。

共享棋牌室照明设备定时控制解决方案

1. 背景与需求

在共享棋牌室（无人值守）场景中，痛点在于 “人走灯不灭” 或 “人来无灯” 导致的体验差与电费浪费。我们需要通过智能化改造，实现照明设备与订单系统的联动。核心需求：

• 自动通电： 用户下单成功后，在预约时间前自动打开包间照明。

• 定时关闭： 订单结束后，自动关闭照明及总电源。

• 手动干预： 用户在小程序端可随时控制照明（如：开启、关闭）。

• 状态同步： 硬件状态实时反馈给云端。

2. 硬件选型与接口能力

为实现上述需求，我们选用芯步专为包间场景设计的硬件，利用其开放的 HTTP API 进行集成。

关键接口解析：根据芯步开放平台文档，设备控制采用标准 POST 请求，通过签名验证安全性。控制照明（假设接在第1路）的命令格式如下

• 开启照明：{"power1":"1"}

• 关闭照明：{"power1":"0"}

• 批量操作：{"batch":{"relay":[1,2],"power":0}} （同时关闭灯和麻将机）

3. 系统架构与集成逻辑

系统架构分为三层：用户层（小程序/后台）、业务层（商户SaaS系统）、设备层（芯步云及硬件）。

1. 设备配网与绑定： 智能控制器通电后，通过配网模式连接2.4G WiFi。商户后台通过扫描设备二维码将 device_id 与具体的 room_id（包间ID）绑定，并将 AppID、AppSecret 存入数据库。

2. 核心集成流程： 业务系统作为中间件，接收订单事件触发 API 调用，或接收传感器 Webhook 消息触发指令。

4. 定时开关解决方案详解（技术实现）

本方案重点在于“定时”，针对预约开场和订单结束两个场景分别处理。

4.1 第一种场景：预约时间到了，自动开灯

逻辑： 用户通过小程序预约 19:00-21:00 的包间。

1. 系统检测到订单状态变为“已支付”。

2. 后端服务启动一个定时任务（如利用 Quartz 或 Redis过期事件），设定在 18:55（提前5分钟）执行。

3. 代码实现逻辑：

   # 伪代码示例:发送HTTP请求控制照明 import requests import hashlib import time def control_light(device_id, action): ts = int(time.time()) # 签名字符串生成 (AppSecret + ts 的 MD5，具体看官方文档) sign = hashlib.md5(f"{APP_SECRET}{ts}".encode()).hexdigest() url = f"http://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}" payload = { "device": device_id, "order": {"power1": action} # action = 1 开启 } response = requests.post(url, json=payload) return response.json() # 定时任务触发 (如: 18:55) # control_light(device_id_123, 1)

4.2 第二种场景：订单结束，自动关灯/断电

逻辑： 订单结束时间到达（或用户点击“提前离店”）。

1. 触发源： 订单服务检测到 end_time 已到。

2. 执行指令： 调用关闭接口。

3. 高级策略（防止用户超时）：

   • 预提醒： 订单结束前10分钟，利用控制器的 TTS 语音播报功能播放“如需续费请在小程序操作，否则将断电”。

   • 断电执行： 调用 order 为 {"power1":"0"}。

   • 延时断电（可选）： 为了给用户留出出门时间，可以设置延迟指令。

   // 调用先断后通接口，实现延时关闭照明 { "order": { "reset": { "relay": [1], "interval": 60000 // 60秒后关闭照明 } } }

4.3 第三种场景：防浪费与节能（传感器联动）

若用户在订单时间内离席（如吃饭），但灯一直亮着会耗电。通过 人体存在传感器 实现精细化控制。

1. 订阅设备状态： 在芯步控制台配置消息推送 URL。当检测到无人超过 N 分钟，传感器会向你的服务器发送 {"radar":"0"}。# 无人状态

2. 业务逻辑：

   • 服务器收到“无人状态” -> 记录时间戳。

   • 若持续无人 15 分钟 -> 检查当前订单状态（若还在有效期内）-> 发送指令关闭照明并关闭麻将机电源（节能）。

   • 用户回来：传感器探测到 radar 变为 1 -> 服务器自动恢复照明和麻将机电源。

5. 指令汇总与调用策略

为了方便开发，下表汇总了Mini控制器（4路）在本次方案中的指令映射策略：

6. 总结

通过集成芯步的 智能包间控制器 及其 开放 HTTP API，我们可以快速实现共享棋牌室的照明定时控制。该方案的核心优势在于：

1. 无需网关：设备直连 WiFi，减少故障点 。

2. 高精度定时：通过服务器端任务调度，确保开关准时。

3. 状态闭环：结合传感器上报与语音播报，提升用户体验的同时降低运营能耗。