共享台球厅：怎么把4路交流输出控制器接入到自己的项目中_解决方案

CATALOG

这是一篇关于如何将芯步4路交流输出控制器接入共享台球厅项目的解决方案。我尽量写得接地气一点，不讲太多虚的，直接上干货。

把4路控制器变成台球厅的“智能电管家”——手把手接入教程

兄弟们，做共享台球厅最头疼的是啥？不是没人来打球，而是人走了灯没关，空调吹一天，电费哗啦哗啦的。或者客户在手机上订了两个小时，到点了不好意思赶人，结果下一单的客人来了没台子。

这本质上就是个“谁付钱，谁用电”的问题。芯步那个4路交流输出控制器（型号一般是 UNI-KZQ-AC-4），其实就是专治这个毛病的。今天咱们就聊聊，怎么把这玩意儿塞进你自己的项目里，让它变成你的“远程电管家”。

第一步：这东西能干啥？先搞懂物理极限

在写代码之前，咱们得先摸清这硬件的脾气。这玩意儿有4路继电器，说白了就是4个可以远程控制的“开关”。

接什么？ 它控制的是 220V 交流电。台球厅的灯带、排风扇、甚至那个大功率的饮水机，都可以直接串在上面。
功率多大？ 单路最大能扛 2200W（阻性负载，比如灯），全加起来别超过 4400W。一张台球桌上面的灯一般也就几百瓦，放心接，完全够用。
怎么联网？ 这货只认 2.4G WiFi。如果你台球厅用的是那种双频合一的路由器，最好在后台把它俩分开，让设备连 2.4G，不然容易掉线。

第二步：核心玩法，让你的服务器能吼它

这设备最大的好处就是开放接口（Open API） ，而且官方说永久免费，这点挺良心。它不走复杂协议，就是简单的 HTTP 请求。无论你的后端是 Java、Python，还是 PHP，甚至你用微信云开发，只要能发 HTTP 请求，就能控制它。

这里有个关键点：签名计算。说白了就是为了安全，防止别人随便刷你的接口把灯打开。你需要搞到三个东西：

AppID：相当于你的账号。
AppSecret：相当于你的密码（这个千万别写在前端代码里！）。
Device ID：就是贴在设备上的那个设备编号。

控制逻辑其实就两步：计算签名： 按照官方规则 md5(md5(开发者密码) + 时间戳) 算出一个字符串。发送指令： 往 https://api.thingboot.com/{AppID}/device/v1/control/ 这个地址发一条指令，告诉它“把第一路打开”。

第三步：业务逻辑闭环，从用户下单到自动断电

光知道怎么发指令没用，关键是怎么跟你的订单系统挂钩。这里给兄弟们一个简单的流程图参考：

第一种场景：用户下单成功当用户在微信小程序里付了钱，订单状态变成“已支付”。这时候，你的服务器除了通知门锁开门，还应该干一件事：调用芯步接口，把对应台球桌的那一路（比如第1路）开关闭合。

第二种场景：用户开台打球灯亮了。如果客户在页面点“开台”，你可以顺便把这一路的 URL 状态记录在 Redis 里，方便后面随时查。

第三种场景：计时结束 / 用户提前关台如果用户点击“结束订单”，或者订单倒计时归零。这时候你的系统要自动调用接口，把那一路断开。如果台球厅是分区的，还可以顺便把该区域的空调（第4路） 一起关了。

场景四：紧急情况万一用户在房间里闹事或者忘了关灯？你的管理后台可以做一个“急停按钮”，手动强制断开所有继电器，安全第一。

第四步：实际操作，几行代码搞定控制

理论上讲清楚了，我们来点实际的伪代码逻辑。假设我们用 Node.js 举个例子（换成 Python 也一样，就是发请求）：

const crypto = require(‘crypto’);
const axios = require(‘axios’);

// 配置信息，从芯步后台拿
const config = {
    appId: ‘你的AppID’,
    secret: ‘你的AppSecret’,
    deviceId: ‘设备ID（贴在硬件上）’
};

// 控制函数:控制第几路，开还是关
async function controlRelay(routeNum, status) {
    // 1. 准备时间戳和签名
    const ts = Math.floor(Date.now() / 1000); // 10位时间戳
    // 签名算法: md5(md5(秘钥) + ts)
    const md5Secret = crypto.createHash(‘md5’).update(config.secret).digest(‘hex’);
    const sign = crypto.createHash(‘md5’).update(md5Secret + ts).digest(‘hex’);

// 2. 组装数据 (注意:一般官方的body里需要带上设备ID和开关指令)
    // 具体参数名请参照官方文档，一般是 device_id 和 switches
    const body = {
        device_id: config.deviceId,
        switch: status, // 1 或 0
        outlet: routeNum  // 1, 2, 3, 4
    };

// 3. 发起请求 (注意URL路径格式)
    const url = `https://api.thingboot.com/${config.appId}/device/v1/control/`;
    
    try {
        const response = await axios.post(url, body, {
            params: { ts: ts, sign: sign }
        });
        if (response.data.code === 200) {
            console.log(`第${routeNum}路已${status === 1 ? ‘开启’ : ‘关闭’}`);
        }
    } catch (error) {
        console.log("控制失败，检查网络或签名", error);
    }
}

// 业务调用:用户支付成功，开灯！
// controlRelay(1, 1);

第五步：进阶玩法，不只是开关灯

如果你想让台球厅更“智能”，其实还有更多玩法：

1. 防“蹭电”机制有的客户打完球没关小程序就直接走了。你的后端可以每分钟轮询一次订单状态，如果订单已结束但检测到电流负载还在（通过API查状态），强制断电。

2. 老板的省电模式利用这设备的定时任务功能。比如设定凌晨2点到早上8点，如果检测到该路电流低于阈值（没人用），直接物理断电，避免有些设备有“待机功耗”。

3. 结合4路输入这设备不仅有4路输出，其实还带了4路开关量输入。你可以接一个物理急停按钮在吧台。如果有人违规闯入，按下按钮，直接触发输入信号，设备立刻断开所有输出。这在安防上很有用。

总结一下避坑指南

WiFi 稳定性：千万别图便宜用杂牌路由器。一台工业级AP覆盖整个球房没多少钱，但一个掉线就能让你收到客户投诉“灯打不开”。
签名安全绝对不要在前端（小程序、APP）直接计算签名和调用芯步接口，必须走后端。否则你的 AppSecret 暴露了，别人能把你的灯玩成蹦迪现场。
零线共接：接线的时候注意，这4路输出是共用一个零线（N线）端子的。电工师傅接的时候要确认火线进，火线出，别接短路了。

把这4路控制器搞定，你的共享台球厅基本上就能实现24小时无人值守了。省下来的看店人工费，那可都是纯利润。