CATALOG

棋牌室无人化改造的核心是包间电源的远程控制,芯步的8路控制器通过HTTP API可实现对麻将机、空调、灯光等设备的独立管控。以下是完整的接入方案,涵盖选型、对接流程和关键代码逻辑。

解决方案:基于芯步8路控制器的棋牌室电源集成方案

1. 设备选型与场景分析

针对棋牌室包间,核心需求是独立控制每个包间的照明、麻将机、空调、排风扇以及门禁锁。芯步的 【智能通用控制器 8路 (UNI-KZQ-TY-8) 】是该项目的最佳选择

  • 核心优势:提供8路物理继电器输出,意味着一个设备可以管理一个包间内的所有强电设备,无需购买多个单路开关,降低了布线复杂度和成本。

  • 负载匹配:单路最大支持2200W阻性负载,完全覆盖麻将机、换气扇及LED照明;若接入空调,通过控制器驱动交流接触器来带空调,以延长设备寿命

  • 接口开放:该设备支持标准的HTTP API接口,支持云端和局域网本地控制,响应速度极快(局域网端约50-100ms),适合高并发的订单场景

2. 硬件部署与接线规划

在你开展项目前,需要先规划好物理接线。假设一个标准棋牌室包间:

线路编号推荐负载说明
线路1总照明/LED灯带基础照明
线路2麻将机核心娱乐设备
线路3排风扇/吸烟灯空气循环
线路4空调内机需配合接触器或直接控制(视功率而定)
线路5饮水机/茶具服务型电器
线路6插座顾客手机充电等
线路7广告灯箱/门头营业状态展示
线路8门禁锁电源配合电磁锁,实现订单开始通电开锁,结束断电锁门

接线提醒:设备工作电压为DC 12V,需放置在弱电箱或包间吊顶内,强电线(220V)接入控制器输入端,负载线接至输出端

3. API对接流程与技术实现

芯步的接口采用标准的HTTP POST请求,签名验证机制确保了API调用的安全性。

3.1 前期准备
  1. 注册开发者账号:登录芯步官网,进入工作台,获取专属的 AppIDAppSecret

  2. 设备配网:通过“物联网控制台”将8路控制器连接至包间WiFi(仅支持2.4GHz),获取设备唯一ID(device_id)。

3.2 签名算法

为了防止接口被篡改,每次请求需计算签名 sign。公式如下

  1. step1 = md5(AppSecret)

  2. step2 = step1 + ts (ts为当前Unix时间戳)

  3. sign = md5(step2)

3.3 核心控制代码示例

你可以使用任何后端语言(Java、Python、Go、PHP)调用接口。以下是一个通用的控制逻辑示例(伪代码/逻辑描述):

API请求地址https://api.thingboot.com/{AppID}/device/control/?sign={YourSign}&ts={timestamp}

请求参数

场景逻辑:用户下单成功当用户在微信小程序支付包间费用后,你的后端服务需要执行以下操作:

  1. 计算签名:使用你的 AppSecret 和当前时间戳计算 sign

  2. 下发开锁指令

    • 通常门禁接在第8路(power8)。

    • 命令:{“power8”: 1} —— 电磁锁通电,门锁打开,用户进入包间

  3. 下发通电指令

    • 开启照明、空调和新风。

    • 命令:{“power1”: 1, “power3”: 1, “power4”: 1}

  4. 注意:麻将机线路默认通电,因为麻将机本身有开关,用户需要自行按桌上的开关。

场景逻辑:用户订单结束用户点击退场或订单时间耗尽时,执行断电操作:

  1. 总清指令:为防止遗漏,可直接下发关闭所有线路的指令。

    • 命令:{“power1”: 0, “power2”: 0, “power3”: 0, “power4”: 0, “power5”: 0, “power6”: 0, “power7”: 0, “power8”: 0}

  2. 二次确认:在断电后延迟1-2秒查询一次设备状态,确保所有电器关闭,避免浪费电费。

3.4 获取设备实时状态

除了控制,你还需要在管理后台看到每个包间灯光的通断状态

  • 方法:芯步提供了设备状态查询接口(device/status);如果你的服务器支持,也可以配置设备状态回调,当有人按了墙壁开关的物理按键时,设备会主动上报状态到你的服务器,保持系统同步

4. 高级功能集成

  • 语音播报提醒:芯步部分8路控制器支持TTS语音功能。当用户还剩15分钟结束时,你的服务器可以通过API发送语音指令给包间控制器

    • 指令示例:{“play:gbk:16”:“尊敬的顾客,您的包间时间还剩15分钟,如需续费请扫码。”}

  • 本地局域网控制(高稳定性):如果棋牌室的网络环境不稳定,可以利用设备的局域网API功能。你的本地服务器可以直接通过设备的IP地址发送HTTP指令,不经过云端,响应更快,且外网断网时依然可以控制包间断电

5. 避坑指南

  1. 感性负载问题:电机类设备(麻将机、空调压缩机)属于感性负载,在断电时会产生火花,长时间可能导致继电器触点粘连。严格控制空调线路的功率,若空调功率大于700W,请一定要加装交流接触器

  2. WiFi信号强度:8路控制器依赖2.4G WiFi。如果包间处于角落或金属门较多,确保信号强度在-60dBm以上,否则可能出现指令超时

  3. 上电状态设置:在芯步控制台中,可以配置“上电状态”。设为恢复断电前状态。这样一旦路由器重启或设备重启,包间不会自动亮灯导致误操作

通过上述方案,你可以将芯步8路控制器无缝集成到你的棋牌室SaaS系统中,实现从订单支付 -> 开锁 -> 通电 -> 计费 -> 断电的全自动化闭环管理。