共享台球室的痛点在于“人走灯不灭、门常开”导致的能耗和安全隐患。以下方案基于芯步智能包间控制器与密码门禁，通过触摸按键+HTTP接口实现用户自助开门、自动通电、离开现场时断电的完整闭环。
1. 背景与需求分析
在共享台球室（无人值守模式）的运营中，包间门禁控制与照明/设备用电管理是核心刚需。传统方案中，用户入场需前台协助开门、开灯，离开现场时时易忘记关灯关空调，导致能耗浪费和安全隐患。
本方案的目标是利用芯步的智能硬件产品及开放接口，解决以下痛点：
远程/本地触摸控制：用户通过小程序下单后，可在包间门口的触摸门禁上输入密码或在手机端一键开锁。
设备联动：门锁开启的瞬间，自动点亮照明、接通台球桌上方灯及空调插座。
计时计费联动：设备通电时长与用户订单时长绑定，离开现场时自动断电。
2. 硬件选型与架构
针对台球室包间环境，选择以下两款硬件，全部通过芯步的开放接口（HTTP API）进行控制和状态上报。
| 设备名称 | 型号/版本 | 核心功能 | 在本方案中的作用 |
|---|---|---|---|
| 智能包间控制器 | UNI-KZQ-BJ | 7路独立继电器控制（含大功率空调口），支持220V强电通断，带开关量输入接口 | 控制照明、球桌灯、排风扇、空调。接收门磁开关信号 |
| 智能密码门禁 | 触摸版 | 触摸按键输入，支持密码验证，HTTP接口远程控制，12V电锁控制 | 控制电磁锁（磁力锁或电插锁）的开关，提供用户交互界面 |
| 人体感应传感器 | （选配） | 探测活体移动 | 实现“无人自动关灯”的节能策略 |
系统拓扑逻辑：
控制端：用户手机（小程序） / 包间门口触摸面板
网络层：Wi-Fi（2.4GHz）直连云端
管理层：芯步云平台（API）
执行端：智能包间控制器（接灯/空调） + 智能密码门禁（接锁）
3. 核心功能实现逻辑
3.1 触摸按键控制门禁
场景：用户到达包间门口，通过小程序获取密码或动态二维码附近的触摸屏输入。
实现步骤：
下发密码当用户在小程序端成功支付订单后，后台服务器调用芯步 API 向对应包间的 智能密码门禁 下发指令。
命令示例：设置一个时效性密码（如：123456），并设定该密码的有效期恰好为用户购买的时长。
触摸按键开门用户在门禁触摸屏上输入
123456并确认。设备验证通过后，内部继电器吸合，电磁锁断电（或通电）实现开门。状态反馈门禁开启的同时，门磁传感器（通常选配或利用控制器输入接口）将“门已开”状态回传至云端。
3.2 门禁与照明联动控制
场景：开门瞬间，黑暗的球房灯光自动亮起，排风扇开始工作，空调启动。
实现原理：利用“开关量输入联动”或“云端逻辑触发”。
方案 A（推荐-本地联动） ：智能包间控制器 具备开关量输入接口 。可将智能密码门禁的“开锁输出信号线”接入智能包间控制器的开关量输入端子（IN端口）。通过配置（在芯步控制台设置联动规则），当门禁输出开锁信号时，控制器直接触发
power1（照明）和power2（球桌灯）接通，延迟几乎为 0 秒。方案 B（云端联动） ：
Step 1：后台服务收到门锁开启的回调通知（Webhook）。
Step 2：后台服务调用
智能包间控制器的 API。命令
{"power1":1, "power2":1, "power5":1}（1为开，0为关）。
3.3 离开现场时自动断电与节能
场景：用户订单时间结束或用户点击“结束订单”，系统自动关灯锁门；若用户提前离开但未结束订单，系统利用传感器自动检测关灯。
订单结束强制断电用户点击小程序“结束订单”或计时时间耗尽。
API调用：
POST /device/control/->order: {"power1":0, "power2":0, "power5":0}。同时发送门禁锁门指令（若需要复位门禁状态）。
智能节能（人体感应方案） ：若包间内无人超过 10 分钟（例如用户去上厕所但忘了关灯），利用芯步的 人体感应传感器 探测：
探测逻辑：若传感器状态为“无人”持续 10 分钟，云端自动下发关灯指令，但仍保持门禁待机状态，避免用户回来看不见路 。
4. 芯步 API 接口对接详解（面向开发者）
芯步的硬件开放接口基于 HTTP POST 请求，签名机制保证了设备安全性 。以下为集成进共享台球室管理系统的核心代码逻辑：
4.1 获取签名（Sign）
所有请求都需要携带动态签名，防止伪造请求。生成算法Sign = md5( md5(AppSecret) + ts )示例逻辑（伪代码）：
4.2 开门指令（控制门禁）
当用户在手机端点击“开门”或在后台管理员手动开门时调用。
URL
https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}Body
4.3 灯光与空调控制（控制包间控制器）
当用户下单成功或点击开灯时调用。
URL：同上
Body
注：智能包间控制器支持 30A 大功率输出，可直接接 2匹空调节省了交流接触器的成本和空间 。
4.4 批量控制与场景模式
芯步的硬件支持批量控制，非常适合“开场模式”和“清场模式”。
开场模式
{"batch":{"relay":[1,2,4,5],"power":1}}(同时开启照明、球桌灯、插座、空调) 。全关模式
{"power":0}(切断所有线路) 。
5. 解决方案的优势
高度集成，简化布线传统的共享棋牌室/台球室方案中，门禁控制器和灯光控制器往往是分离的，需要复杂的弱电强电转接。而芯步的 智能包间控制器 内置了 7 路输出，且支持直接接入开关量信号，可以将门禁信号线直接接入，硬件集成度比较高，施工简单 。
触摸按键更耐用相比机械按键，电容式触摸按键在公共场合（台球室灰尘大、可能有饮料泼溅）更易清洁、无磨损、寿命更长 。
组网灵活所有设备基于 WiFi 2.4GHz 联网，无需额外布置网关中继器（除非面积超大），适合存量台球室的快速改造安装 。
场景化 TTS 播报选配 TTS 版本的控制盒，当用户开门或计时结束前，可以自动播报“欢迎光临”或“您的订单还剩 10 分钟，请及时续费”，提升无人值守场景的互动感 。
6. 实施注意事项
网络覆盖：每个包间必须确保 WiFi 信号强度在 -70dBm 以上，每个包间独立部署或使用 Mesh 组网，避免门禁和控制器掉线。
门锁类型匹配：智能密码门禁输出的是开关量信号，需确认包间门是 12V 磁力锁（断电开）还是电插锁，接线需匹配电源功率 。
安全冗余：在门口旁侧保留一个物理的“紧急开门”按钮（接入控制器的开关量输入），以备网络故障时由管理员或消防应急使用。
通过上述方案，共享台球室可实现完全无人化值守，用户仅需通过触摸按键交互即可实现从进门到用电的全自助服务。