方案:通过芯步开放接口实现8路包间设备的“一键复位”
1. 场景痛点与解决思路
开棋牌室、茶楼或剧本杀店的朋友肯定遇到过这种情况:客人走了,麻将机还亮着、空调呼呼吹、灯也没关。阿姨一间间去关累死人,要是忘了关空调,电费蹭蹭涨。要是等到下一波客人来了再手忙脚乱地开,体验感也很差。
我们的目标是:客人离店(或下机)时,管理员点击一下“打扫/重置”按钮,系统自动把包间里所有设备恢复到初始状态(比如:麻将机断电、灯具全灭、空调保持待机、门锁上电)。
这里用到的是芯步 8路包间控制器(智能包间控制器|Max) 。这玩意儿就是为此设计的,8路输出,灯、麻将机、空调、门锁全都能接。
2. 准备工作:搞懂“复位”到底要控制啥
既然是“复位”,我们先设定一下默认状态(假设包间打扫干净,等客来的状态):
第1-3路(照明):关闭
第4-6路(插座/麻将机/饮水机):关闭(客人走了拔插头)
第7路(门锁):开启(如果是电磁锁,通电锁门或断电锁门要看接线,通常是通电上锁,重置要保证关门状态)
第8路(空调):这里要小心,直接断电伤空调。一般都是发红外指令让它关机,或者如果接的是通断,就保持通电但给个关机信号。为了简化方案,如果空调不支持红外遥控,我们可以把它当成一个普通电器,断电复位。
3. 实操接入:如何调用API
芯步的接口非常直白,不用搞复杂的SDK,直接发HTTP请求或MQTT就行。
假设你手里有一台设备ID为 123456 的8路控制器,想要把1-6路和8路全关掉(复位)。
方法一:最直接的“单路操作”
你可以一条一条发指令。虽然代码啰嗦,但逻辑最清晰。
API地址: https://api.thingboot.com/{你的AppID}/device/control/请求方式: POST请求体 (JSON)
方法二:更专业的“批量指令”
手册里提到支持batch命令,或者直接在一个order里写多个参数,这能减少网络请求量。
如果你希望一键把所有路都关了(除了锁),可以直接这样发:
小贴士:如果老板想要“打扫模式”,需要灯全亮但不启动麻将机,那你就把power1,2,3设成1,power4设成0即可。
4. 进阶玩法:自动化和“先断后通”
有些设备(比如老式麻将机)刚断电马上又来电容易出故障。芯步的接口支持“先断后通”的时序控制。比如你想重启路由器(接在第5路),想让它断电10秒再开:
你可以在后台配置这个动作的间隔时间,这样就不用自己写sleep函数了。
5. 如何集成到你的收银系统?
既然你有这个需求,多半是有个自己的管理系统。集成步骤如下:
获取凭证:在芯步开放平台后台拿到你的
AppID和AppKey,用于生成签名sign。记得带上时间戳ts防重放攻击。触发时机:在你的收银系统里,点“下机/结账/清理房间”按钮时,触发上述HTTP请求。
进阶:配合人体传感器,当客人离开包间且5分钟无人移动,自动触发复位。
确认执行(防呆设计)有时候信号不好,咋知道设备真的关了?你可以调用获取设备详情接口 (
/device/info/) 查看当前state里的power1是不是0。或者订阅芯步的消息推送,设备执行成功会反推一条消息到你的服务器。
6. 避坑指南(口语化重点)
空调那点事:第8路虽然有30A大继电器,直接断电虽然简单,但变频空调直接断电容易烧主板。买带TTS语音播报和红外的版本,或者单独配个红外遥控器,通过API发“关机”指令,而不是直接“断电”。
别忘了门锁逻辑
power7控制门锁。复位的时候千万别把门锁给“断电”了,除非你是断电开锁的电插锁(那样门就开了,不安全)。一般是复位时确保门锁处于闭门通电上锁状态。API地址别记错:注意芯步的接口分为
设备控制和分组控制。如果你想同时复位8个包间,可以先在后台把“所有包间”建一个分组,然后调/group/control/接口,传group=1和power1=0...这样一条指令就把楼上楼下全关了。
总结代码示例(Python / Node.js 伪代码)
假设你用Python写后端:
这样一来,你就不用买很贵的整套“共享棋牌室SaaS硬件”,用芯步的开放接口自己攒一套就行了,省事儿又省钱。