CATALOG

共享棋牌室现在越来越火,但人工开关灯太麻烦,顾客也容易忘关。这篇方案会一步步教你,如何把芯步的AC4-30A智能通断器通过HTTP接口,对接到你自己的棋牌室管理系统里,实现顾客扫码自助开灯、时间到了自动关灯。

一、 这玩意儿能干啥?(解决你的痛点)

如果你是做共享棋牌室系统的,最烦的是什么?是顾客打电话说“老板开下灯”,还是打完牌走了灯开了一整晚?这个AC4-30A其实就是个“大号智能开关”。它能装在配电箱里,直接控制棋牌室里的麻将桌插座、大吊灯、排气扇。

对接之后,你的系统就能做到:

  1. 顾客下单:自动通电开灯/通麻。

  2. 时间管理:订单结束前10分钟自动闪烁提醒,时间到自动断电。

  3. 远程控制:老板在后台直接关掉某个房间的电器。

二、 准备工作:你需要先拿到这三样东西

在写代码之前,你得先去注册个账号,把设备配上网。

  1. AppID:你的“身份证号”。

  2. AppSecret:你的“密码”,别泄露。

  3. Device ID:这个开关的编号。一般在设备标签上,或者在后台能看到。

小贴士:这玩意儿只支持2.4G WiFi,配网的时候记得让手机连2.4G的信号。

三、 核心逻辑:怎么让它听你的话?

它的控制原理很简单:你的服务器 -> 发命令给芯步云 -> 芯步云推送给开关 -> 灯亮了。

芯步用的是动态签名验证,也就是说,你不能直接写死一个密码去发请求,得按照它的规则算一个sign出来。

签名算法(直白版)AppSecret 进行MD5加密,然后拼接上当前的时间戳,再整体MD5一次。

公式sign = MD5( MD5(AppSecret) + ts )

四、 实战代码(只需要几分钟)

不管你是用Java、Python还是PHP,甚至是用小程序的云开发,只要支持HTTP协议就行。

1. 请求地址

https://api.thingboot.com/{你的AppID}/device/control/

2. 请求参数你需要传三个东西:sign(签名)、ts(时间戳)、以及要控制的device和命令order

3. 核心示例(以最常用的Python为例)

假设你的棋牌室系统后端是Python写的:

五、 高大上一点的玩法:高级定时命令

既然是共享棋牌室,肯定不是单纯的“开”和“关”。比如顾客买了3小时,你得让他一直有电。如果你要在服务器里写个定时任务去轮询关灯,太麻烦且不准。

更好的方案:利用硬件自带的“定时复位”功能。

AC4-30A 支持 reset 命令。意思是“打开,并在xx毫秒后自动关闭”。

场景应用

  • 场景A:顾客扫码下单你不需要发两条指令(开灯、等3小时后再关)。你可以直接发一条指令:

    解释power:1 是立即通电,reset:10800000 是告诉硬件,3小时后(3*60*60*1000毫秒)自动断电。优点:哪怕你的服务器宕机了,或者网络断了,时间一到,这个开关自己就会掐断电源,绝对不浪费电。

  • 场景B:顾客加钟顾客中途续费了2小时,怎么搞?如果只是再发一个定时,时间会乱套。这时候可以先发命令清除状态,再重新计时:

六、 注意这几个坑

  1. 返回200并不代表灯一定亮了这是新手最容易迷糊的地方。返回200只代表“芯步云端收到指令了”。如果设备没网或者坏了,它还是没反应。真正的成功执行,需要监听云端推送的消息,但对于大多数棋牌室应用来说,只要网络稳定,200基本上就够了。

  2. 功率限制AC4-30A最大支持6600W。一般一个包间里的灯、麻将机、排气扇加起来可能也就300-500W,足够了。但注意,如果是大功率空调,单独接一个,不要把所有电器都串在一个通断器上。

  3. 设备ID一定要核对测试的时候,千万别复制粘贴错了Device ID,错了就是“设备不存在”错误。

总结一下

把AC4-30A接进你的共享棋牌室项目,其实就是“注册账号 -> 拿到三个ID -> 按规则算签名 -> 发HTTP请求”。最难的部分其实就是那个sign的算法,但直接复制上面的代码,把参数替换一下,就可以跑通了。

一旦联调通了,你的系统就能直接控制物理世界里的电灯和麻将桌了。这对于做SaaS平台来说,是比较成熟的解决方案了。