共享台球室的无人值守场景，痛点在于“远程授权”与“本地控制”的闭环——用户下单后如何自动开门、超时后如何断电提醒。芯步的开放接口正好解决这个问题：通过HTTP API将小程序订单系统与门禁/电源设备打通。以下是具体方案。

芯步共享台球室无人值守门禁控制系统解决方案

一、 建设目标与原理

本方案的目标是利用芯步开放的 API 接口，将传统台球室包间门禁（磁力锁/电插锁）、总电源控制器与线上（小程序/公众号）订单系统打通。实现 “用户手机下单 -> 服务器授权 -> 包间通电/开门 -> 计时结束 -> 自动断电关门” 的全流程无人化管控。

二、 硬件选型与集成

针对台球室包间场景，需选配支持芯步开放接口的以下硬件：

1. 智能门禁控制器/单灯控制器（核心） ：

   • 选型理由：选择芯步生态中支持 HTTP/TCP 协议的继电器或智能面板。该设备负责接收云端指令，执行“通断”操作。

   • 接线逻辑：将设备串联进门禁锁的电源回路以及包间总照明电源回路。

2. 智能语音音柱

   • 用于在用户即将超时或门未关好时，通过 API 调用播报语音提示，提升用户体验。

3. 人体存在传感器（雷达/红外） ：

   • 用于逻辑互锁。防止用户误关门窗或系统在有人状态下强行断电，确保安全。

三、 接口集成方案 (API 对接流程)

芯步开放平台提供标准的 HTTP 接口，这是实现控制的关键。具体步骤如下：

1. 设备侧配置（联网）

• 所有硬件设备（门禁控制器、语音喇叭）通过 WiFi 2.4G 或 4G 连接网络。

• 在芯步控制台中获取唯一的 Device ID（设备编号）和 API Key。

2. 业务系统对接（信号接收与下发）

你需要在自己的小程序或 SaaS 后台中，编写逻辑来调用芯步的接口。典型流程如下：

• 场景 A：用户下单成功（支付完成）

  • 逻辑：服务器收到支付成功回调。

  • 动作：服务器构造 JSON 请求，向芯步 API 发送 control 指令。

  • 代码示意（HTTP POST） ：https://api.thingboot.com/{AppId}/device/control/

    { "device": "包间门禁设备ID"， "order": {"power": 1} // 1表示闭合继电器，即给门磁通电/解锁开门 }

  • 结果：包间门锁断电弹开，同时照明电路接通。

• 场景 B：计时结束前提醒（防超时）

  • 动作：服务器在订单结束前5分钟，调用语音音柱接口。

  • 结果：语音播报“您的订单即将结束，如需加时请扫码续费”。

• 场景 C：计时结束（强制断电）

  • 动作：服务器再次调用 API。

  • 结果：继电器断开，包间内台球桌、空调电源切断，门禁锁通电吸合（锁门），等待下一组客人。

3. 传感器联动（安全保护）

• 如果用户在未下单的情况下误入包间，门磁传感器或人体雷达传感器会通过 “上行消息推送” 机制，将状态变化推送到你的服务器。

• 服务器接收到“非法闯入”信号后，可联动摄像头录像或推送警报至管理员手机。

四、 详细实施步骤

第一步：硬件安装与接线

• 强电注意：在配电箱处安装智能控制器。将包间的“总闸”输出端接入智能控制器的输入端，再从控制器输出端接到包间设备。由持证电工操作。

• 门禁接线：磁力锁接控制器 NO（常开）接口。常态下电路断开，门是吸合的；需要开门时，API 指令让继电器吸合，电路接通，磁力锁瞬间断电失去吸力，门即弹开。

第二步：网络配置

• 打开芯步 APP/后台，将设备配置为“Station模式”连接门店 WiFi。

• 记录下每个设备的 Device ID 并与包间号（如：Room_01）在本地数据库中做好映射。

第三步：接口调试（核心代码逻辑）

• 获取签名：为防止恶意攻击，芯步接口通常要求携带 sign（签名）。公式一般为 md5 (path + “?” + query + body + “&key=” + AppKey)。

• 测试指令：使用 Postman 模拟服务器向设备发送 {“power”：0}（断电），观察门禁是否吸合。

第四步：边缘场景优化

• 断网保护机制：需在后台设置 “断电保护逻辑” 。如果网络断网，本地控制器无法接收 API 指令，应配置本地定时逻辑（如：检测到门磁开启 60 分钟后未收到续费指令，强制断电）。

五、 数据结构与状态反馈

为了实现精准控制，你需要在你的业务数据库与芯步设备之间同步以下字段：

• 状态同步机制：设备端如果有物理按钮（物理出门开关），按下后需上报状态给服务器，防止服务器认为门未开而报错。

六、 注意事项

1. 门锁类型适配：如果是电插锁（通电上锁），请请一定要将接口指令逻辑反转（即 power：1 表示上锁，power：0 表示解锁），避免逻辑混乱导致门关不上。

2. 音频提示的时机：在 “设备断电前 2 分钟” 利用语音音柱进行倒计时播报，而不是断电瞬间，以免用户因突然断电而产生投诉。

3. 私有化部署：若数据安全性要求比较高，可咨询芯步技术团队进行局域网部署（纯局域网内 HTTP 通信），但需要注意手机端 4G/5G 网络无法直接访问内网 IP 的问题，通常需搭配 VPN 或云桥接。

通过上述集成，可实现用户扫码支付 -> API 下发 power：1 -> 门锁弹开 -> 人走断电 的完整闭环。