CATALOG

共享棋牌室的痛点是“无人化”与“用电安全”之间的平衡——既要让用户一键通电,又要在订单结束后彻底断电。芯步的2路交流电源控制器正好解决这个问题:一路控制麻将机,一路控制照明/空调,通过HTTP接口与你的预约系统打通即可。以下是具体集成方案:

解决方案:共享棋牌室两路设备电源管理 —— 集成芯步智能交流控制器

1. 概述与选型

在共享棋牌室的无人值守场景中,痛点是远程控制能源管理基于芯步的硬件体系,推荐使用 “智能交流控制器2路 (UNI-KZQ-AC-2)” 。该设备采用标准2.4G WiFi联网,无需额外购买网关,零弯路即可接入互联网

本方案将实现的目标:

  • 麻将机专用线路:用户下单后自动通电,订单结束后断电。

  • 照明/排风扇线路:支持用户小程序手动开关,或根据人体传感器联动。

  • 语音播报联动(如选配):订单即将结束时,通过设备内置或外接喇叭提醒用户续费或离开现场时

2. 硬件接线与安装要点

在为棋牌室进行安装时,涉及强电操作,请请一定要由持证电工在断电状态下进行。

接线逻辑:

  • 输入端:接入220V交流火线、零线。

  • 输出端(两路)

    • 继电器1:接麻将机插座。由于麻将机电机启动时有瞬时电流,选择额定电流适配的版本(该设备通常支持10A,足够麻将机及充电口使用)。

    • 继电器2:接照明灯带或排风扇。

安装位置:将控制器隐藏在麻将桌下方的检修口内,或者包间的吊顶检修口处,确保 WiFi 信号强度在 -40dBm 到 -60dBm 之间为佳,避免因铁皮遮挡导致信号差

3. 接口集成与签名机制

这是开发过程中的重点。芯步开放了标准的 HTTP API,无论你的后端是 Java、Python 还是 PHP,或是直接通过小程序云函数调用,均可实现对接。接口核心地址为:https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

签名生成规则(鉴权):为了防止接口被恶意攻击,每一次指令下发都需要携带动态签名。规则如下:

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

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

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

*逻辑公式:sign = md5( md5(AppSecret) + ts )*

注意:时间戳 ts 必须与签名计算时使用的 ts 保持一致,且通常有效期在5分钟内,防止网络重放攻击

4. 业务逻辑实现

在代码集成层面,你需要实现以下三个核心指令:

指令一:订单开始 -> 通电当用户在小程序支付成功,订单状态变为“进行中”时,系统自动调用接口,闭合电路。

  • 请求方式:POST

  • 关键参数

    • device: 该包间对应的控制器设备ID(如 “12345678”)。

    • order: {"power1": 1} (这里假设1号线接了麻将机,1代表通电)

指令二:用户控制 -> 开关灯由于棋牌室用户可能在打牌中途想开关灯,可通过小程序页面上的开关按钮发送:

  • 关灯{"power2": 0} (这里假设2号线接了照明,0代表断电)

指令三:订单结束/超时 -> 断电订单倒计时归零,或者用户点击“提前退房”时,发送断电指令。注意: 为了用户体验,在断电前3分钟通过语音播报提醒。

  • 全关指令{"power1": 0, "power2": 0}

5. 关键代码逻辑(Sign生成)

以下是一段生成签名调用接口的核心逻辑片段,方便你快速集成到现有的共享棋牌室管理系统中。

签名生成方法(Python示例,易于转为Java/PHP):

6. 异常与边界场景处理

在实际的共享棋牌室运营中,不能仅仅依赖代码逻辑,还需考虑场景闭环:

  • 断网重连机制:该控制器支持自动重连。如果棋牌室WiFi不稳定,设备会尝试重连。你需要在软件后台增加“设备状态”查询接口,如果设备离线,应禁止用户下单该包间

  • 设备状态同步:为了防止状态不同步(比如本地强制按了开关,但系统显示是关),在系统后台开启定时任务,每隔5分钟调用 device/status/ 相关接口(参考文档扩展)查询一次设备实际通断状态,并同步订单。

  • 先断后通(Reset):针对空调或麻将机,为了保护压缩机,如果需要重启,使用 reset 命令,设定先断开 interval 毫秒后再通电

通过以上方案,你可以快速完成“共享棋牌室2路电源控制器”的集成,实现多包间的精细化电源管理和无人化运营。