包间预约的痛点是“人到了电没通”或“人走了电忘关”——传统模式下,商家需要手动为每个包间送电、门禁解锁,客人等待体验差,夜间空转的电费也在悄悄流失。
芯步智能包间控制器MINI的开放接口,恰好能打通“订单支付完成”到“包间通电”这最后一米。这套方案的核心逻辑是:用预约订单作为触发信号,通过HTTP接口调用控制器,自动完成门禁解锁和电器通电。
一、 核心改造逻辑与硬件选型
要实现“预约联动通电”,关键在于将业务软件(预约系统)与硬件设备(控制器)通过API串联。
硬件:
智能包间控制器MINI (UNI-KZQ-BJ-MINI) :该设备支持4路独立控制,且具备WiFi联网与HTTP接口开放能力。
辅助传感器(可选但推荐) :如“智能人体存在雷达传感器”,用于检测包间真实 occupancy 状态,防止恶意占座或离开现场时忘关。
硬件接线方案(4路分配):为了达到最佳体验,对控制器的4路进行如下物理接线配置:
第1路(照明/氛围灯) :控制主照明、灯带等。
第2路(核心插座) :控制麻将机、茶吧机、电视等插座电源。
第3路(门禁) :接电磁锁或电插锁。这一路的逻辑是断电开锁(保持通电锁门,订单开始前断电,用户推门进入;或者订单结束后断电清场)。
第4路(空调) :控制2匹以下空调的电源。
二、 技术对接架构
本方案采用云云对接或局域网对接模式。由于控制器支持HTTP直接控制,无需网关,架构非常轻量:
业务端(你的小程序/管理后台) :负责处理用户支付、生成订单。
云端/服务器:你的业务服务器。
设备端:包间内的4路控制器Mini。
交互流程:用户在小程序下单支付 -> 服务器生成有效订单 -> 服务器调用芯步Open API -> 控制器接收到指令 -> 对应线路闭合 -> 设备通电/门禁解锁。
三、 详细实施步骤
1. 设备初始化与网络配置
首先需要对控制器进行配网,使其能与服务器通信。
参照手册为设备通电。
通过芯步提供的配网工具,将设备连接到门店的2.4G WiFi网络。
关键点:记录下这台设备的唯一标识符 Device ID(例如:820720),这是后续API调用时识别“哪一个包间”的关键凭证。
2. 开放接口对接(签名与请求)
芯步的接口采用AppID + Sign签名认证。你的服务器需要具备构造合法HTTP请求的能力。
签名生成逻辑(以备你在后端实现):请求地址结构为: http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
在实际开发中,后端需要按照如下规则生成签名sign
获取当前时间戳
ts。将开发者密码
AppSecret进行一次MD5加密。将上一步结果拼接上时间戳
ts。对拼接后的字符串再次进行MD5加密,得到最终签名。
3. 核心指令下发(联动通电)
在用户支付成功的那一刻,服务器需立即向对应包间的控制器下发指令。
第一种场景:用户下单成功(包间解锁 + 通电)此时用户尚未进入,应先开启基础照明,并临时解开电磁锁(如果是断电开锁类型)。
请求方式:POST
命令示例
注:电磁锁通常长通电为锁门状态,断电为开门,用户推门进入。几秒钟后,你需要发送指令
{“power3”: 1}让锁恢复供电锁闭,确保安全。
第二种场景:用户入座后(全功率模式)如果传感器或用户在小程序点击“开始使用”,开启全部设备。
命令示例
4. 联动传感器实现“无感”与节能
结合芯步的人体存在传感器,可以进一步提升体验。
离座检测:当订单进行中,但雷达传感器检测到包间内无人超过10分钟,服务器可自动调用接口将
power4(空调)调至节能模式或关闭,防止浪费。离开现场时清理:订单结束后,用户离开,传感器检测到无人,服务器发送全关指令。
四、 关键状态同步与异常处理
在实际运营中,你需要处理以下逻辑以保证系统的健壮性:
设备状态查询用户在APP端看到的“灯是否开着”,是通过调用设备状态查询接口(
/device/status)获取的。前端轮询或通过WebSocket推送状态。超时自动断电(计费结束联动)这是无人值守的核心。当订单剩余时间为0时,你的服务器需自动执行以下命令:
参考batch命令格式,[1,2,4]代表关闭第1、2、4路。
语音播报提醒(TTS版本)如果你采购的是TTS版本,可以在断电前发送语音提醒:“您的订单即将结束,请注意保存”。
命令
{ “play”: “您的包间时间即将用完,如需续费请扫码” }。
五、 方案总结
通过在芯步智能包间控制器MINI中集成开放接口,你可以将传统“计时收费”升级为“全自动无人值守”模式。开发者仅需关注订单生命周期(开始、进行中、结束)与API调用(通电、断电)的映射关系,无需关心底层电路实现。
该方案具有部署轻量(WiFi直连)、集成简单(标准HTTP)、控制精准(独立4路)的特点,能显著降低棋牌室、茶室等共享空间的运维人力成本。