这是一个针对棋牌室、茶楼或影音包间的技术对接方案。我尽量少讲理论,直接上“干活”的逻辑,希望能帮你理清思路。
一、 为什么要做“联动”?
咱们经营棋牌室或茶室的,最怕什么?最怕客人到了,门锁还没开;最怕客人走了,空调还开着,电费哗哗跑;最怕半夜接到电话说包间门没锁。
这套方案的核心逻辑就是:客人下单 -> 系统自动通电 + 开门 -> 时间到了 -> 系统自动断电 + 锁门。
我们要用的是芯步的 “智能包间控制器” (这玩意儿专门为这种场景设计的,一路接门锁,六七路接麻将机、空调、饮水机),再配合他们的HTTP接口,把你现有的小程序或管理后台变成万能遥控器。
二、 我们需要什么硬件?
芯步智能包间控制器:这是主角。
它有专门接电插锁/磁力锁的接口(一般是直流输出)。
它有控制麻将机、空调、照明的继电器接口。
全都在一个86面板或者盒子里面,不占地方 。
电磁锁:装在门框上。
电源:12V直流电源(给锁供电)。
三、 对接流程:怎样用HTTP接口把它叫醒?
芯步的接口挺友好的,不用搞复杂的SDK,只要你会POST请求就行 。
1. 看一眼接口地址
他们统一的入口是这样的(大概是这个结构):http(s)://api.thingboot.com/{你的AppId}/device/control/?sign={签名}&ts={时间戳}
这里稍微口语化解释下:
AppId:相当于你在芯步的“大门钥匙编号”。ts和sign:是为了防止别人捣乱,把你的请求加密一下。简单说,就是把你的密钥和时间戳混在一起,做个MD5加密 。
2. 核心命令:怎么开门、怎么送电?
假设你的包间号是“888”,设备ID是123456。我们要通过后台发指令:
第一种场景:客人下单成功,开门并通电客人一付款,你的服务器就往芯步的设备发一条JSON数据:
注意门锁的逻辑坑:磁力锁通常是断电开门的。如果你接的是“断电开”的锁,那命令逻辑就要反过来,比如 "power7":0 代表开门。我们要结合实际情况来写代码。
第二种场景:时间快到了,提醒+断电器客人还有5分钟下机,我们可以发一条“先通后断”的命令,让空调关掉,或者让喇叭播报一下:
第三种场景:客人退单,锁门断电这就是最简单的全关命令:
四、 实战步骤:从0到1搭起来
光有HTTP接口不行,还得连上线。咱们一步步来。
第一步:设备配网(让设备上网)
拿到设备先别急着装墙里。
微信小程序搜“芯步”。
把设备通电,按着开关不放,听到“嘀”一声或者指示灯快闪。
在手机小程序里输入咱们店里的WiFi密码(只能是2.4G频段的WiFi,双频路由器记得分开设置)。
看到小程序提示“配置成功”,这时候设备就有IP地址了,云端就知道它在线了。
第二步:拿到设备ID
在芯步的“物联网控制台”后台,找到刚添加的设备,复制那个 “设备ID” 。这个ID就是我们HTTP请求里要用的那个。
第三步:写几行代码(或者用低代码)
不管你用什么语言,核心就是发HTTPS请求。这里用伪代码或者命令行演示一下,很直白:
假设你是PHP/Python/Node.js后端,只需要这几步:
拼接头像:
AppSecret进行MD5加密 + 当前时间戳 -> 再整体MD5一次,得到sign。发送POST请求,Header里带上
Content-Type: application/json。Body里带上
{"device":"设备ID","order":{"power1":1}}。
实际效果:只要请求返回 code: 200,设备那边立刻就有反应,延迟通常在100毫秒左右,基本感觉不到卡顿 。
五、 针对“包间门禁”的特殊处理
因为门禁涉及安全,这里单独给两个,都是实际安装中容易踩的坑:
1. 门磁反馈(判断门是否真的关了)虽然HTTP接口能下发“锁门”指令,但有时候门可能被东西卡住了,没真正合上。
做法:芯步的控制器其实支持接门磁传感器。我们可以通过另一个接口查询门磁状态(开/关)。
逻辑:客人离开现场时后,系统自动锁门。如果有异常(门没关好),通过微信公众号给老板/客人发个告警,别等半夜才发现门是大敞着的。
2. 物理开关的保留有时候断网了怎么办?
:保留墙上的物理出门开关。在对接接口的同时,把门口的物理开关接到控制器的“干接点”输入端。这样即使断网,按一下物理按钮,门也能开,客人不会被锁在里面。
六、 总结一下这个解决方案的好处
省电:没人自动断电,不用服务员一间一间去查房。
省事:客人线上支付,自动开门,全程无人值守。
灵活:这个HTTP接口是通用的,以后想增加个烟雾报警器联动、或者远程关空调,只需要改改
order里的参数就行,硬件不用动 。
这样描述是不是比较清晰了?总之就是:你发个带签名的快递(HTTP请求)给芯步的服务器,服务器负责派送(下发给设备),设备执行(开门/通电)。 按照这个路子对接,包间门禁联动就搞定了。