CATALOG

包间预约联动通电的核心思路是:用你的业务系统作为“大脑”,在用户下单后自动调用控制器接口通电,并在订单结束时断电。以下方案以芯步4路包间电源智能控制器MINI为例,完整说明接口调用流程和关键代码逻辑。

一、 解决方案架构概述

本方案的核心是将您的业务系统(小程序/公众号/Web端)芯步云平台API以及智能控制器MINI三者串联起来。

  • 硬件端:4路包间电源智能控制器MINI。它负责物理执行通电(第1-4路)和门禁控制(第3路)。

  • 网络层:设备通过WiFi连接云端,支持公有云API局域网私有化控制。

  • 软件端:您的业务服务器通过调用芯步提供的开放HTTP API接口,实现与硬件的指令交互。

工作流程:用户下单支付 -> 系统生成预约订单 -> 调用API下发通电指令 -> 控制器接通电路 -> 用户使用完毕 -> 系统自动/手动调用API断电。

二、 业务逻辑实现

为了实现“预约联动通电”,通常需要在包间使用前、使用中、使用后三个阶段执行不同的指令。

第一步:用户预约成功时(自动通电)

当用户在您的小程序下单支付成功后,您的后台服务器应立即触发指令,为该包间通电。

  1. 控制门禁(第3路):打开电磁锁,让用户能进入房间(如果是自助模式,通常是断电开锁或通电开锁,需根据锁类型配置)。

  2. 控制总电(第1、2、4路):接通照明、麻将机、空调等电源。

  3. 语音播报(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-Typeapplication/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调用的映射关系

实施步骤:

  1. 登录芯步控制台获取 AppIDAppSecret

  2. 将设备配网并绑定到您的账号下。

  3. 编写一个简单的函数封装 sendCommand($deviceId, $orderData)

  4. 在用户下单成功的回调函数中,调用该函数发送上述JSON指令。

控制器产品方案:
怎样在无人值守包间设备控制中接入智能设备以实现HTTP接口远程独立控制通断
查看 >>
如何接入智能 24 路远程开关控制模块来实现远程控制24路线路
查看 >>
如何接入共享空间智能控制器以实现自定义联动操作
查看 >>
共享自习室包间管理:怎么将8路包间灯光空调控制器接入到软件项目中
查看 >>
如何二次开发4 路智能照明控制器来实现定时开关照明设备电源
查看 >>
4路场景方案:
怎么在4路10A/16A/30A多规格输出控制器MINI中接入智能设备来实现包间设备运行时长统计
查看 >>
怎么在4路包间电源智能控制器MINI中对接智能设备来实现包间智能语音联动控制
查看 >>
4路服务门店包间专用控制器MINI:怎么将4路远程包间电源管理模块MINI集成到自己的项目中
查看 >>
怎样在酒店客房照明控制中集成智能硬件来实现4路独立线路控制
查看 >>
怎么在4路包间多回路控制模块MINI中对接智能硬件来实现远程重置包间设备状态
查看 >>
通电用途方案:
怎样二次开发4路共享空间智能控制器MINI以实现包间预约联动通电
查看 >>
如何在私人影院包间场景中接入智能硬件以实现包间预约联动通电
查看 >>
怎样在私人 K 歌房包间控制中对接智能硬件以实现包间预约联动通电
查看 >>
怎样在智能4路包间控制器MINI中集成智能硬件来实现包间预约联动通电
查看 >>
怎么二次开发8 路智能包间控制器以实现包间预约联动通电
查看 >>