CATALOG

方案:通过芯步开放接口实现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. 如何集成到你的收银系统?

既然你有这个需求,多半是有个自己的管理系统。集成步骤如下:

  1. 获取凭证:在芯步开放平台后台拿到你的 AppIDAppKey,用于生成签名 sign。记得带上时间戳 ts 防重放攻击

  2. 触发时机:在你的收银系统里,点“下机/结账/清理房间”按钮时,触发上述HTTP请求。

    • 进阶:配合人体传感器,当客人离开包间且5分钟无人移动,自动触发复位

  3. 确认执行(防呆设计)有时候信号不好,咋知道设备真的关了?你可以调用获取设备详情接口 (/device/info/) 查看当前state里的power1是不是0

    或者订阅芯步的消息推送,设备执行成功会反推一条消息到你的服务器。

6. 避坑指南(口语化重点)

  • 空调那点事:第8路虽然有30A大继电器,直接断电虽然简单,但变频空调直接断电容易烧主板。买带TTS语音播报和红外的版本,或者单独配个红外遥控器,通过API发“关机”指令,而不是直接“断电”

  • 别忘了门锁逻辑power7控制门锁。复位的时候千万别把门锁给“断电”了,除非你是断电开锁的电插锁(那样门就开了,不安全)。一般是复位时确保门锁处于闭门通电上锁状态。

  • API地址别记错:注意芯步的接口分为设备控制分组控制。如果你想同时复位8个包间,可以先在后台把“所有包间”建一个分组,然后调/group/control/接口,传group=1power1=0...这样一条指令就把楼上楼下全关了

总结代码示例(Python / Node.js 伪代码)

假设你用Python写后端:

这样一来,你就不用买很贵的整套“共享棋牌室SaaS硬件”,用芯步的开放接口自己攒一套就行了,省事儿又省钱。