共享棋牌室的照明管理痛点在于:如何在无人值守的情况下,让用户下单后自动通电、离店后自动断电,同时兼顾老板的远程干预能力。以下方案基于芯步的HTTP开放接口,通过4路智能控制器实现对包厢照明和电器的精细化控制。
1. 背景与选型
在共享棋牌室(无人值守模式)的运营中,照明和电器的管理直接关系到用户体验和节能。
痛点:用户离开后忘记关灯、空调;需要人工前往现场断电;高峰期无法及时响应包间临时断电需求。
目标:用户线上下单后自动通电,到点自动断电,且支持管理员远程操控特定线路。
核心选型芯步 智能控制器4路(交流电压版)。
理由:该设备支持4路独立控制,可以分别控制“主照明”、“氛围灯带”、“麻将机插座”、“空调插座”。交流电压版直接接入220V市电,安装于配电箱内,完美适配现有强电线路 。
技术优势:无需网关,直连WiFi 2.4G;支持标准HTTP接口,兼容现有SaaS系统(小程序/后台) 。
2. 设计
该方案的对接逻辑分为三层:设备层 -> 云平台层 -> 应用层。
设备层:安装4路控制器,灯路接在继电器输出端。设备通过WiFi连接互联网,并注册到芯步平台。
云平台层:作为桥梁,接收应用层的指令,转换为MQTT协议推送给设备。
应用层:您的棋牌室SaaS系统(小程序后台)。通过调用芯步的开放API,发送HTTP请求控制设备。
业务流程如下:
用户下单 -> 小程序通知SaaS后台 -> SaaS调用
/device/control接口 -> 4路控制器闭合(开灯/开空调)。订单结束/超时 -> SaaS系统主动调用关闭接口 -> 4路控制器断开(断电)。
紧急情况 -> 老板/保洁通过管理后台点击“断电” -> 执行一样的HTTP接口逻辑。
3. 核心对接流程与技术实现
要实现“远程通断”,关键在于正确组装并发送HTTP请求至芯步的开放平台。
3.1 准备工作
注册/登录:在芯步开发者平台注册账号,获取
AppID和API Key(用于生成签名)。设备配网:将智能控制器上电,通过“芯步”APP或小程序配置WiFi,获取设备的唯一标识符——
Device ID(如:1000123456)。
3.2 接口调用详解
控制指令通过向特定URL发送POST请求实现。根据芯步公开的接口规范,核心指令如下:
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方法:POST
请求头 (Header)
Content-Type: application/json
第一种场景:单路开/关(最常用)
例如:棋牌室3号包间的订单开始,需要开启“主照明”(假设接在第1路)。
对应效果:第1路继电器吸合,灯泡亮起。
第二种场景:一键全开/全关
例如:保洁打扫完毕,一键关闭所有电器,或批量控制多间房。
对应效果:所有线路断开,全屋断电,安全节能。
第三种场景:先通后断(脉冲模式)
适用场景:复位麻将机(通过短暂断电让麻将机自动复位洗牌)或解决设备死机。
对应效果:麻将机关闭2秒后自动重启,无需人工拔插插头。
4. 与棋牌室SaaS系统的业务集成方案
光有接口还不够,必须将其融入业务逻辑中。在您的系统中做如下规则配置
4.1 “订单开始”触发器
触发条件:用户支付成功,订单状态变更为“进行中”。
执行动作:调用控制接口,开启该包间关联的设备ID的第1路(照明) 和第4路(空调/新风)。
友好提示:可在设备端配置“状态保持”命令,确保用户入场前灯光已亮。
4.2 “订单结束/超时”触发器
触发条件:订单剩余时间归零且未续费,或用户点击“退场”。
执行动作:调用全关接口(
batch指令将所有路power置0)。缓冲策略:如果不希望立即全黑导致差评,可以设定关闭策略——延时5分钟后关闭照明,或只保留微弱氛围灯。
4.3 “老板远程干预”面板
功能:在管理后台设计一个简易面板,展示每个包间设备的状态。
实现:调用设备状态查询接口(芯步提供),获取当前
power1/2/3/4的状态,展示开关图标。点击图标即可发送对应的开关指令。
4.4 异常报警联动
安全:结合芯步的传感器接口。
逻辑:如果烟感传感器(同平台设备)触发警报,后台自动调用所有设备控制接口,强制全开照明并切断总闸,辅助顾客逃生。
5. 实施注意事项
设备负载限制
智能控制器4路交流版单路最大负载通常为2200W阻性负载。
照明:没问题。
空调/麻将机:需注意其为感性负载,降额使用(如单路控制在1000W以下)。如果是一拖多的中央空调/大功率柜机,加装交流接触器(小电流控制大电流) 。
网络稳定性
设备仅支持2.4G WiFi,确保棋牌室路由器信号覆盖配电箱位置。
如果不具备公网条件(如地下室没信号),可选购支持局域网部署方案的版本,将请求地址改为局域网IP,断外网也能用 。
签名验证
所有HTTP请求都需要携带
sign签名和时间戳ts,以防止接口被恶意攻击。服务端需封装统一的签名生成函数,确保调用芯步接口时参数加密正确 。
6. 总结
通过在现有棋牌室SaaS系统中集成芯步智能4路控制器,仅需几行HTTP代码即可解决繁琐的现场管理问题。该方案实现了:
无人化:订单驱动自动化,无需前台。
精细化:4路分控,照明、娱乐、温控互不干扰。
智能化:支持脉冲复位、状态查询等高级功能。