台球厅 VIP 包间管理：怎么把8路远程包间管理控制器对接到自己的项目中_解决方案

CATALOG

芯步的8路包间控制器通过HTTP API开放接口，可以像调用普通REST接口一样集成到你的台球厅管理系统中。以下从硬件选型、接口对接逻辑到业务场景，给出完整方案。

1. 解决概述

对于台球厅VIP包间管理，最核心的需求通常是：顾客自助开台通电、时间到期自动断电、包厢内空调/麻将机等大功率电器的独立管理，以及紧急情况下的远程控制。 单纯依靠威宏等传统计费软件往往只能管理“灯控”，难以精细化控制空调等大功率设备。

通过对接芯步智能包间控制器|Max （UNI-KZQ-BJ-MAX） ，可以直接利用其开放的HTTP API接口，将您的管理软件、小程序与硬件设备打通。这套方案不仅支持局域网和公网控制，还可以实现私有化部署，数据更安全。

2. 硬件选型与电气规划

在您的“VIP包间”场景中，选型直接采用 Max型号（8路） ，因为VIP包厢通常包含更复杂的用电设备。

推荐设备： 芯步智能包间控制器|Max （UNI-KZQ-BJ-MAX）选配： UNI-KZQ-BJ-MAX-TTS （含语音播报版，用于订单提醒或欢迎语）

8路端口物理接线规划（VIP包间版）：

端口编号	类型/负载能力	接入设备	业务逻辑说明
第1路	10A 开关	照明灯光	入门总控，开台即亮，关台自动关闭。
第2路	10A 开关	排风扇/新风系统	可定时关闭，或根据烟雾传感器联动。
第3路	10A 开关	氛围灯带/射灯	高级VIP包间可做场景模式（打球模式、休息模式）。
第4路	16A 插座	麻将机	VIP包间常备，独立控制，按需通电。
第5路	16A 插座	饮水机/茶吧机	配合定时任务，避免夜间干烧浪费电。
第6路	16A 插座	充电插座/按摩椅	供顾客手机充电或付费体验设备。
第7路	10A 门禁专用	电磁锁（电插锁）	关键：实现自助开门。订单生效后开门，结束后断电锁门。
第8路	30A （大功率）	2匹空调	痛点：传统方案难以控制空调，此路数专门针对空调继电器，实现自动开关。

3. API对接深度详解

芯步的接口设计非常标准，基于 HTTP POST 请求，只要您的项目能发起HTTP请求即可对接。无论是您现有的威宏计费软件进行二次开发，还是独立的小程序SaaS系统，都适用。

3.1 核心认证与签名机制（Sign）

为了避免接口被恶意攻击，接口使用了动态签名验证。您的后端需要生成一个 sign 参数。

公式sign = md5（ md5（AppSecret） + ts ）
参数
- AppID：控制台获取的开发者ID。
- AppSecret：开发者密码。
- ts：当前Unix时间戳（秒）。

关键点：时间戳 ts 通常有效期为10分钟左右，且签名不可逆，这保证了从您服务器发起的指令是合法的。

3.2 核心请求地址

POST https://api.thingboot.com/{AppID}/device/control/？sign={YourSign}&ts={ts}
Content-Type: application/json

3.3 典型场景API开发示例

以下是针对台球厅场景的几种常见API调用逻辑，可用任意后端语言（Java/PHP/Python/Node.js）实现。

第一种场景：顾客小程序下单，系统自动开台（开门+开灯+开空调）当用户支付成功后，您的后台应发送如下命令包，使用 batch 批量控制接口一次性执行，减少网络开销。

请求参数：
{ "device": "设备唯一ID（例如:1878）"， "order": { "batch": { "relay": [7， 1， 8]， "power": 1 } } }
逻辑：同时开启第7路（门锁）、第1路（照明）、第8路（空调）。

第二种场景：顾客中途加时 / 到点提醒系统可以在离结束还有5分钟时，调用来提醒客户续费。

请求参数（TTS版本专属）：
{ "device": "1878"， "order": { "play:gbk:16": "尊敬的顾客，您的包间时间仅剩5分钟，如需续费请扫码。欢迎下次光临" } }
注：gbk：16 代表音量，可根据环境嘈杂程度调整。

第三种场景：顾客离开现场时结账，统一断电（全关+门禁锁定）当顾客点击“退场”或预定时间已到时，执行全关命令，确保安全与节能。

请求参数：
{ "device": "1878"， "order": { "batch": { "power": 0 } } }

场景四：紧急情况或保洁打扫有时候顾客离开现场时但没关门，保洁需要打扫，需要暂时解锁门锁或单独开灯，但不希望开启计费。

请求参数（单路控制）：
{ "device": "1878"， "order": {"power1": 1} } // 仅亮灯 { "device": "1878"， "order": {"power7": 0} } // 强制解锁门锁

4. 高级功能与SaaS架构

1. 定时任务与无人值守场景： 台球厅非营业时段（如凌晨2：00 - 早上8：00）自动断水断电。实现方案： 利用芯步控制台自带的“远程定时任务”功能，或者直接在您的云服务器设置Cron定时任务，调用API接口，强制所有包间执行全关指令，同时也起到了自动巡检的作用。

2. 传感器联动（进阶智能化）为了进一步提升VIP体验，可以引入芯步的传感器产品线。

人体存在传感器：当系统是“空闲”状态，但传感器检测到有人移动时，说明有顾客未扫码闯入，您的系统后台可触发警报或自动向管理员推送消息。
联动逻辑传感器检测到有人 -> 上报数据到您的服务器 -> 您的服务器判断设备状态 -> 调用API关闭电源并推送警告。

3. 网络部署

稳定性：该设备仅支持2.4GHz WiFi。在施工布线时，请请一定要确保包间内2.4G信号覆盖良好，或者使用企业级AP，避免使用双频合一的“智能家居”模式，以免设备掉线。
局域网IP化：如果您的台球厅网络架构比较复杂，或者老板担心外网断网导致无法控制，可以咨询芯步技术关于局域网/私有化部署方案。该设备支持局域网发现和控制，即使断网，只要店内局域网通，仍能控制。

5. 联调与测试流程

注册与创建：注册芯步账号，创建一个工作台，进入物联网控制台。
设备配网：给控制器通电，通过App或控制台将设备配网绑定到您的账号下，获取 Device ID。
代码试跑：拿官方的Curl或PHP/Python示例代码，修改 AppID、AppSecret 和 Device ID，直接在命令行或IDE里跑一下，看能否控制插座通断。
逻辑嵌入：将这段代码封装成函数（如 ctrlDevice（$deviceId， $order）），替换您现有台球系统里的“开台”、“结账”按钮的后端逻辑。

总结

通过将芯步8路控制器的API与您的台球计费系统对接，可以将传统的计时收费升级为全无人值守的VIP智能包厢。关键是利用好 第7路（门禁） 实现自助进出，利用第8路（大功率） 解决空调管理难题，利用 Batch接口 实现一键场景切换。