CATALOG

共享台球厅要实现真正的“无人值守”,核心瓶颈往往不是预约小程序,而是门禁与订单的状态联动——用户付了款,门该怎么开?订单结束了,又如何防止超时占用?以下方案基于芯步硬件接口,给出完整的对接逻辑与落地细节。

1. 项目概述与分析

在共享经济浪潮下,24小时无人值守台球厅已成为实体创业的热门选择。然而,要实现真正的“无人化”,首要解决的痛点是用户预约与物理空间进入权限的闭环管理。具体表现为:如何在不配备前台人员的情况下,让付费用户在预定时间段内顺利进入包间,并在订单结束后自动限制进入?

本方案基于芯步的智能硬件开放接口,设计一套完整的门禁控制系统对接流程。该系统旨在取代传统的人工登记或钥匙管理,实现“用户手机下单 -> 后台授权 -> 扫码/远程开门 -> 自动复位”的全自动化流程。

2. 方案选型:硬件设备推荐

在芯步的产品体系中,针对台球厅、棋牌室等商用场景,推荐使用以下两类硬件以实现对门的控制,而非普通的家庭智能门锁。

根据台球厅的实际装修和电路情况,我们提供两种硬件选型方案:

特性方案A:智能密码门禁方案B:智能分体控制器 + 电磁锁
适用场景高端包间、写字楼入户门低成本改造、需要同时控制门和灯光的包间
控制对象门禁一体机(集成读头与控制器)外接磁力锁/电插锁 + 门禁开关电源
联网方式WiFi 2.4G 直连WiFi 2.4G 直连
核心优势支持动态密码下发,用户无需接触门锁接口统一,可同时联动控制包间内的灯光或插座
控制逻辑验证密码/远程开门通断门锁电源实现“断电开门”

对于台球厅包间门,方案B(智能分体控制器 + 电磁锁) 更为专业。其原理是:智能控制器控制门锁电源的通断。平时电磁锁处于通电吸合状态(门紧闭);当需要开门时,控制器瞬间断电,电磁锁失去磁力,门即被打开。这种方案抗破坏性更强,且符合商用消防要求。

此外,若需实现更高集成度的环境控制(灯光、空调联动),可参考智慧空间方案中对网关与人体存在传感器的配置

3. 核心技术对接:接口调用逻辑

芯步硬件最大的优势在于开放了HTTP API接口,这意味着你可以使用任何后端语言(Java, Python, PHP, Node.js 等)或小程序云函数直接调用,无需复杂的嵌入式开发

3.1 身份验证机制

为了确保安全性,每次请求都需要携带签名(Sign)。签名生成逻辑如下:

  1. 将你的 AppSecret 进行一次 MD5 加密得到 Secret_MD5

  2. Secret_MD5 与当前的时间戳(秒级)ts 拼接。

  3. 将拼接后的字符串再次进行 MD5 加密,得到最终的 sign

算法公式sign = md5( md5(AppSecret) + ts )

3.2 核心开门指令实现

要实现“远程开锁”,只需向指定接口 POST 一段 JSON 数据。

请求地址示例:https://api.thingboot.com/{YourAppId}/device/control/?sign={sign}&ts={ts}

请求体示例(针对“智能分体控制器”控制门锁线路):

参数解析:

  • device:即你安装在台球厅包间内的控制器ID。

  • order:控制指令。

  • reset:这个命令极其适合门禁场景。5000 代表“先断开电路(开门),5000毫秒(5秒)后自动恢复电路(关门锁闭)”。这防止了门锁长时间开启的安全隐患。

3.3 与业务系统的联动

在一个标准的“共享台球厅”小程序项目中,对接流程应如下设计:

  1. 用户下单:用户在微信小程序选择时间段(如 20:00-22:00)并完成支付。此时系统生成一笔订单,订单状态 = 待使用

  2. 远程授权/预授权

    • 方式一(被动开门):用户到达现场点击“开门”。小程序携带用户身份调用云函数,云函数校验该用户当前时间段内是否有有效订单。校验通过后,调用芯步接口 reset 开门。

    • 方式二(动态密码):如果使用了智能密码门禁,下单成功后,系统通过接口生成一个仅在 20:00-22:00 有效的动态密码推送给用户

  3. 状态同步

    • 开门后,系统后台记录该设备状态为“占用中”。

    • 与此同时,系统可联动调用同一个控制器上的其他线路。例如,利用同一个控制器的另一路线路控制台球桌顶灯:{"power1":1},实现“开门即亮灯”的体验,这通常比仅控制门禁更具用户吸引力

4. 关键业务场景实战

4.1 “超时自动断电/禁入”逻辑

无人值守最怕用户超时赖着不走。在系统层面实现双重保险:

  • 软性提醒:订单结束前15分钟,通过 WebSocket 或短信提醒用户。

  • 硬性执行:订单结束后,系统自动调用接口发送 {"power":0}(关闭灯或门锁电源)。一旦用户出门后关门,将无法再次扫码开门(除非续费)。若门磁传感器检测到门未关,还可触发管理员报警。

4.2 远程应急处理

当用户反馈“门打不开”时,管理员后台应设计一个“紧急开门”按钮。点击按钮调用 reset 命令。同时,配合芯步的设备极速响应能力(通常在 80-120ms 内),管理员甚至可以通过远程对讲系统确认现场情况后直接操作

5. 实施注意事项

  1. 网络覆盖:芯步的设备主要依赖 2.4G WiFi。在台球厅装修时,请一定要确保每个包间内 WiFi 信号满格,避免因信号弱导致指令下发超时

  2. 私有化部署(可选):如果你对数据安全要求较高,芯步支持私有化部署。你可以将 API 接口部署在本地服务器,所有指令仅在局域网内传输,不经过公网,极大了提升了系统稳定性

  3. 并发处理:在高峰期(如周末晚上),可能有大量用户同时发起开门请求。芯步接口基于 HTTP 无状态设计,为了支持高并发业务场景,后端服务采用连接池机制,并合理设置超时时间以避免线程阻塞

  4. 电源管理:门禁控制器接 UPS(不间断电源),防止断电导致全部门禁失效无法开门,造成用户投诉。

6. 总结

综上所述,通过对接芯步的开放接口,开发者可以用极短的时间(官方宣称十分钟左右)为共享台球厅项目集成稳定的门禁控制功能。其核心在于利用 HTTP API 实现订单系统与硬件的指令互通,利用 reset 命令实现安全的“点动开门”逻辑。

这种对接方式不仅能控制门禁,由于其接口的统一性,未来你还可以无缝接入灯光控制、插座控制等设备,从而构建一个完整的 SaaS 无人值守生态系统,真正实现一人管多店、24小时低成本运营的商业目标