包间预约联动通电的核心思路是:用你的业务系统作为“大脑”,在用户下单后自动调用控制器接口通电,并在订单结束时断电。以下方案以芯步4路包间电源智能控制器MINI为例,完整说明接口调用流程和关键代码逻辑。
一、 解决方案架构概述
本方案的核心是将您的业务系统(小程序/公众号/Web端)、芯步云平台API以及智能控制器MINI三者串联起来。
硬件端:4路包间电源智能控制器MINI。它负责物理执行通电(第1-4路)和门禁控制(第3路)。
网络层:设备通过WiFi连接云端,支持公有云API或局域网私有化控制。
软件端:您的业务服务器通过调用芯步提供的开放HTTP API接口,实现与硬件的指令交互。
工作流程:用户下单支付 -> 系统生成预约订单 -> 调用API下发通电指令 -> 控制器接通电路 -> 用户使用完毕 -> 系统自动/手动调用API断电。
二、 业务逻辑实现
为了实现“预约联动通电”,通常需要在包间使用前、使用中、使用后三个阶段执行不同的指令。
第一步:用户预约成功时(自动通电)
当用户在您的小程序下单支付成功后,您的后台服务器应立即触发指令,为该包间通电。
控制门禁(第3路):打开电磁锁,让用户能进入房间(如果是自助模式,通常是断电开锁或通电开锁,需根据锁类型配置)。
控制总电(第1、2、4路):接通照明、麻将机、空调等电源。
语音播报(TTS版):如果购买的是TTS版本,可下发指令让控制器喇叭播报“欢迎光临,祝您愉快”。
第二步:预约时间即将结束时(提醒与续费)
利用定时任务,在订单结束前5-10分钟,通过API调用语音播报接口,提醒用户续费,避免中途断电造成不良体验。
第三步:预约时间结束(自动断电)
订单倒计时归零或用户点击退场时,系统调用API切断所有线路。
三、 关键接口对接详解
芯步的接口非常简单,采用标准的HTTP POST请求,您无需关注底层物联网协议,只需关注业务层调用。
1. 鉴权与签名计算
所有API请求都需要携带签名(sign)和时间戳(ts)进行身份验证。
AppID:开发者ID
AppSecret:开发者密码
签名算法(PHP示例逻辑):
注:将密码进行一次MD5,拼接时间戳,再进行一次MD5。
2. 核心指令下发接口
请求地址
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}请求方式:POST
Content-Type
application/json
3. 各场景指令参数示例
以下是针对“4路包间电源智能控制器MINI”在具体联动场景中的JSON指令代码:
第一种场景:预约成功,开启包间逻辑:开门、开灯、开机麻、开空调
注:power1/2/3/4对应控制器上的4个接线端子,1为通,0为断。play:gbk:16为语音播报命令。
第二种场景:临期提醒(如剩5分钟)逻辑:只播报语音,不断电
第三种场景:订单结束,关闭包间逻辑:断空调用待机(空调通常需延时或仅关插座),断灯、断麻将机、锁门
四、 进阶功能与优化
1. 设备状态同步与防作弊
为了确保设备确实执行了指令,您可以利用消息推送功能。
在芯步控制台设置您的“消息推送URL”。
当设备状态改变(如用户手动按了遥控器关空调),平台会实时推送状态到您的服务器。您可以依据此状态进行计费冻结或告警,防止用户私拉乱接导致的安全隐患。
2. 局域网私有化部署(降低延迟)
如果您对响应速度和公网稳定性有比较高要求,控制器Mini支持局域网HTTP控制。
原理:由于设备与服务器处于同一WiFi局域网内(如门店路由器),您可以直接请求设备的本地IP地址进行控制,完全脱离外网。
适用:棋牌室、茶楼等店内自营系统。
3. 防雷击与功率保护
根据产品手册,第4路支持30A(最大6600W),适合直接接空调。在您的系统中设置软阈值(如限制单路功率不超过额定功率的80%),并在API调用失败时触发告警,防止跳闸。
五、 总结
通过芯步提供的标准HTTP API接口,您只需在现有的业务代码中增加几段 curl 请求代码,即可将“4路包间电源智能控制器MINI”无缝接入您的预约系统。整个过程无需复杂的嵌入式开发,重点在于业务逻辑与API调用的映射关系。
实施步骤:
登录芯步控制台获取
AppID和AppSecret。将设备配网并绑定到您的账号下。
编写一个简单的函数封装
sendCommand($deviceId, $orderData)。在用户下单成功的回调函数中,调用该函数发送上述JSON指令。