芯步的8路控制器本身就是为服务门店包间设计的——第7路专门用于门禁电磁锁,其他各路可管理照明、空调、麻将机等设备。以下方案围绕如何通过HTTP接口将这套硬件与你的管理系统对接,实现用户自助开房、定时断电、远程管理等完整联动。
1. 项目概述与需求分析
在现代服务型门店(如共享棋牌室、自助茶室、影院式足浴、琴房、自习室等)的运营中,“降本增效”与“无人值守”是核心诉求。传统的管理方式依赖人工值守:顾客到店需前台登记、服务员带领开门、检查电器、定时催场、最后关电清洁。这种模式人力成本高,且难以实现24小时营业。
痛点:
人力依赖强:需要专人负责开关门、送电、计费结束时断电。
管理滞后:无法实时知晓包间内电器(空调、麻将机)使用状态,常有顾客离开现场时未关空调造成能耗浪费。
体验不佳:顾客需等待服务员操作,缺乏私密性和自助性。
解决概述:本方案基于芯步“智能包间控制器|Max”(型号:UNI-KZQ-BJ-MAX)及其开放HTTP API接口,将包间的门禁、照明、空调、麻将机、通风等设备全部物联网化。通过对接贵方的微信公众号/小程序或SaaS系统,实现“顾客手机下单 -> 系统自动授权开门/供电 -> 到点预警 -> 自动断电退房”的全程自动化联动管理。
2. 硬件选型与功能定义
本次方案选用芯步专为服务门店设计的8路包间专用控制器作为核心枢纽。该设备支持WiFi 2.4G直连,无需网关,且支持私有化部署和局域网控制,具备比较高的集成灵活性。
在具体部署中,针对单个包间,我们将“智能包间控制器|Max”的8路输出进行如下物理定义:
| 线路编号 | 负载能力 | 接入设备 | 逻辑功能定义 |
|---|---|---|---|
| 第1路 | 10A | 照明灯/LED灯带 | 基础照明 |
| 第2路 | 10A | 换气扇/新风系统 | 环境控制 |
| 第3路 | 10A | 吸烟灯/空气净化器 | 空气质量 |
| 第4路 | 16A | 普通插座(饮水机/消毒柜) | 辅助供电 |
| 第5路 | 16A | 麻将机/按摩椅 | 核心娱乐设备 |
| 第6路 | 16A | 投影仪/电视/音响 | 影音娱乐 |
| 第7路 | 10A | 门禁电磁锁/电插锁 | 门禁核心 |
| 第8路 | 30A | 2匹空调(直接控制,无需红外) | 大功率温控 |
关键特性:第7路门禁接口专门适配直流电磁锁,可直接控制门锁的开关;同时(TTS版本)支持远程语音播报,可用于订单即将到时的提醒。
3. 技术对接设计
芯步的设备开放标准HTTP API接口,这意味着任何支持HTTP请求的编程语言(Java, Python, PHP, Go, C#等)或小程序/APP均可轻松调用,无需复杂的SDK集成。
架构拓扑图逻辑:用户端(小程序/公众号) -> 云端SaaS业务系统(你的服务器) -> 芯步开放API -> 包间控制器(WiFi) -> 继电器动作 -> 门禁/电器响应
核心对接逻辑:
控制指令:业务系统通过POST请求携带签名和JSON数据包,向
api.thingboot.com下发指令。状态同步:控制器状态实时上报,业务系统可通过API轮询或设置回调接收设备当前的通断状态(如门是否关好,空调是否还在运转)。
4. 业务流程闭环设计
结合开放接口,设计以下三大核心联动场景:
4.1 第一种场景:自助开房(下单即通电,扫码即开门)
动作:顾客在小程序下单支付。
系统逻辑:订单支付成功后,后台记录当前时间作为服务开始时间。
接口调用
调用
控制命令,对第1路至第6路及第8路(照明、空调、麻将机等)发送{"power":1},为房间通电。注:此时门禁(第7路)应保持断电状态(或通电锁门状态,需根据锁型定义),等待用户到达现场后,通过小程序点击“开门”或蓝牙感应。
开门动作:顾客到达包间,点击小程序“开门”。
接口调用
调用
控制命令,针对第7路(门锁控制)发送一个脉冲命令{"reset":5000}。该命令将断开电磁锁5秒(实现开门),5秒后自动复位锁门。
4.2 第二种场景:使用时预警与时长管理(语音播报联动)
需求:服务结束前15分钟提醒顾客续费。
接口调用:(若选用TTS版本)
发送语音播报指令:
{"play:gbk:16":"尊敬的用户,您的包间使用时间还剩15分钟,如需续费请在小程序操作,以免断电影响您的使用。"}。同时,向门禁发送指令,使门锁处于“常开”或“允许内开外禁”状态(视安全策略而定)。
4.3 第三种场景:自动退房与断电复位
动作:时间耗尽且用户未续费,或用户主动点击“退房”。
系统逻辑
清场断电报备:通过TTS语音播报:“订单已结束,房间即将断电,请带好随身物品”。
全断电操作
调用接口关闭除“门禁”外的所有电器:分别下发
{"power1":0},{"power5":0},{"power8":0}等(或直接调用场景模式,如关闭所有负载)。
门禁重置
确保门禁第7路处于锁止状态(
{"power7":1},根据具体锁型接线确定通电开还是通电关)。此时,顾客无法再次进入,保洁人员可通过管理卡或管理端进入打扫。
打扫模式:保洁进场后,管理员后台点击“清洁模式”,临时通电(照明+换气),清洁完成后一键恢复待租状态。
5. 关键接口对接详解(以“开门”为例)
为了实现0.1秒内的快速响应,开发人员需参照芯步的标准签名规则对接HTTP接口。
请求URL:
https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方式:
POST签名算法:为了提高安全性,接口需要动态签名。
sign = md5( md5(AppSecret) + ts )(其中ts为Unix时间戳,AppSecret在平台控制台获取)。开门指令示例
解析:reset7 代表第7路执行“先断后通”动作,5000代表断开的毫秒数(即开门5秒后自动锁门)。
解析:开启第8路连接的空调设备。
6. 部署安装与网络注意事项
网络要求:芯步控制器使用WiFi 2.4G频段。门店需确保包间内WiFi信号覆盖良好,避免因信号弱导致指令延迟或失败。如果门店规模较大,采用Mesh组网或企业级AP。
接线施工
强电接入:控制器需要从包间总闸接入零火线。由于涉及30A大电流(空调),使用2.5平方以上的国标铜线接入第8路。
门禁接线:第7路为干触点/继电器输出。购买电磁锁时需确认是常开型还是常闭型,对应调整逻辑。强烈联系芯步工程师获取针脚定义图纸。
语音模块:TTS版本的喇叭需引出到天花板检修口附近,防止被遮挡。
私有化部署:若门店注重数据隐私且内网稳定,芯步支持私有化部署。业务系统可直接请求局域网内的设备IP,无需经过公网,响应延时更低(理论上<50ms)。
7. 方案收益分析
节约人力:实现24小时无人值守,预计单店可节省2-3名轮班服务员。
节能降耗:通过系统强制断电,杜绝“离开现场时不关灯/空调”现象,单包间每日可节省空调用电3-5度。
提升效率:顾客自助使用,无缝衔接,翻台率(订单周转效率)得到明显提升。
安全性:30A大功率继电器专门针对空调设计,相比传统智能插排,不易烧毁,安全性更高。
实施:先选取1-2个包间进行改造试用,测试接口稳定性与门锁联动逻辑,跑通“预约-开门-计时-断电”全流程后,再全店铺开。芯步提供全程技术指导服务,可从选型到调试获得其工程师的协助。