共享台球厅：怎么把12路智能灯光控制器接入到项目中_解决方案

CATALOG

共享台球厅的痛点是“人走灯不灭、用电浪费大”，将12路灯光控制器接入系统实现远程分路控制，是降本增效的关键。以下方案基于芯步的HTTP开放接口，详细说明从硬件选型到业务集成的完整路径。

在共享台球厅场景中，通常一个包间或区域包含多张台球桌，每张桌子上方有一盏专用照明灯，此外还有过道灯、氛围灯等。为了实现精细化计费和节能，我们需要对每一盏灯进行独立控制。

选择12路智能照明控制器（如型号：UNI-KZQ-ZM-12）是核心前提。该设备具有以下关键特性，完美契合台球厅场景：

多路独立控制：具备12路继电器输出，每一路均可独立控制通断。这意味着单台设备可以管理最多12张台球桌的照明，成本效益比较高。
强负载能力：支持单路阻性负载（如白炽灯）2200W，感性负载（LED灯、节能灯）350W。台球厅常用的LED无影灯通常为100W-200W，完全满足单路接多盏灯的需求。
开放接口：支持标准的HTTP接口控制，这意味着无论是小程序、公众号、Web管理后台还是安卓/iOS APP，都能轻松调用。

在接入项目之前，需要完成硬件的物理安装与配网，这是后续软件开发的基础。

强电接线
- 输入：控制器需要接入AC 100-265V市电供电。
- 输出：将12路输出端子分别连接到对应台球桌的照明灯零线上（火线直连，零线进控制器，这是常见的照明控制接法）。将12路与台球桌编号（1-12号）一一对应并贴好标签。
网络配置
- 设备内置WiFi模块（仅支持2.4GHz频段）。通过芯步提供的配网工具或小程序，将设备连接到台球厅的商用路由器WiFi上。
- 网络要求：确保控制器的IP地址能访问公网（如果使用芯步默认云平台），或者确保服务器与控制器处于同一局域网内（如果进行私有化部署）。

这是技术实施的核心环节。芯步采用基于HTTP的API设计，无复杂的SDK依赖。

3.1 接口基础信息

请求地址http(s)://api.thingboot.com/{AppId}/device/control/
请求方法：POST
鉴权方式：URL参数签名。
- sign：签名，用于验证身份。
- ts：时间戳，用于防止重放攻击。
- AppId：在芯步开发者后台创建应用后获取。

3.2 核心指令集设计针对12路控制器，后台开发人员需要封装以下核心API供前端调用：

3.3 业务逻辑集成（以小程序为例）共享台球厅通常基于“订单计费”模式。以下是典型的业务闭环代码逻辑：

场景：用户扫码下单 -> 开灯

场景：用户结账/时间耗尽 -> 关灯

仅仅能开关灯是最低要求。利用芯步接口的高级功能，可以显著提升智能化水平。

定时任务与无人值守台球厅通常凌晨2点关门。你可以在管理后台设置定时策略：通过调用API设置定时任务，例如每天凌晨2:30执行 {“power”:0}，强制关闭所有灯，避免员工下班忘记关灯造成的浪费。
传感器联动结合芯步生态中的“人体存在传感器”。当传感器检测到某张台球桌区域无人超过15分钟，可以自动向控制器下发指令关闭该路灯光，并推送消息提醒前台“3号桌客户疑似离开现场时，是否暂挂订单？”，有效防止跑单和占座。
状态同步机制问题：如果保洁阿姨按了控制器上的物理按钮关灯，小程序上的状态不同步怎么办？解决方案：配置状态回调接口。让控制器在被物理操作时，主动上报当前各路的状态到你的服务器。这是一种良好的开发习惯，能保证软硬件状态实时一致。