共享麻将馆的智能化改造,关键在于门禁与照明的联动逻辑——用户下单后自动通电、离开现场时后自动断电,同时还要支持两路独立控制(比如照明一路、麻将桌插座一路)。芯步的开放接口通过HTTP协议即可实现这套逻辑,以下是具体方案。
解决方案:基于芯步开放接口的共享麻将馆门禁照明联动系统
一、 背景与需求分析
在共享麻将馆的无人值守模式中,痛点是远程控制与能耗管理。经营者需要确保用户下单后自动通电,离开现场时后自动断电,且不同设备(照明、麻将桌、空调)需独立控制以避免浪费。
要实现“2路独立线路控制”,通常指:
第1路(照明/氛围线路):控制室内灯光、灯带。
第2路(插座/麻将桌线路):控制麻将桌、饮水机或换气扇。
门禁联动:控制电磁锁或电插锁,实现扫码开门。
芯步的开放平台通过其标准HTTP接口,可完美实现上述三者的逻辑联动与物理隔离控制。
二、 硬件选型方案
基于芯步产品线及共享场景特性,推荐使用 “智能包间控制器” 作为核心控制单元。该设备专为服务型门店设计,支持 WiFi/4G 通信,无需网关。
推荐设备:芯步 智能包间控制器(服务版)
选型理由
多路独立输出:该控制器拥有多达7路独立控制接口,我们可选用其中2路实现需求:
线路1 (照明控制):接入室内主照明、氛围灯带。通常支持
power1指令。线路2 (设备控制):接入麻将桌电源插座、饮水机。通常支持
power2指令。
门禁直连:自带1路门禁接口(NC/COM干接点),可直接控制磁力锁或电插锁。
语音播报:自带TTS语音功能,可在订单开始/结束时自动播报提示。
(注:如装修已预留传统开关,亦可选用芯步的 2路WiFi墙壁开关 ,通过API控制火线通断。)
三、 系统架构与接口逻辑
芯步开放接口基于 HTTP 协议,采用 设备端直连云端 或 用户端通过云端中转 的策略。架构如下:
用户端(小程序/APP):用户扫码请求开门。
业务云端(您的服务器):验证订单状态,向芯步云平台发起HTTP POST请求。
芯步云平台:通过MQTT/HTTP推送指令至包间控制器。
执行端(智能硬件):控制器解析指令,执行继电器吸合,通断220V电路。
核心API接口设计如下:
接口地址
http(s)://api.thingboot.com/{AppId}/device/control/请求方式:POST
鉴权方式:URL携带签名(Sign)、时间戳(ts)。
四、 联动控制流程实现
以下是实现“门禁照明2路独立控制”的具体业务流程:
1. 用户下单与授权
用户在平台下单后,服务器记录订单开始时间。此时,用户点击“开门”按钮,服务器向芯步接口下发命令。
命令示例(开门+全开)服务器需同时下发门禁(持续通电5秒)和线路通断指令。
2. 使用中独立控制
在包间使用过程中,用户可能需要关闭灯光(打麻将时关灯只看牌)但不断麻将桌的电。通过小程序调用接口即可实现独立控制:
关闭照明(独立控制)
开启排风扇(如接在第3路)
3. 订单结束与全断
用户点击“退场”或订单计时结束,服务器需执行断电并锁门逻辑。为了防止用户还在包间内突然断电,通常配合雷达传感器检测无人状态执行。
命令示例(全断)
语音提醒:在执行断电前30秒,下发TTS语音播报,提升体验。
五、 关键接口参数详解(依据官方文档)
为确保开发顺利,需注意芯步接口中的特定参数定义
| 参数指令 | 数据类型 | 对应功能 | 说明 |
|---|---|---|---|
power1 | String ("0"/"1") | 独立线路1 | 典型用于照明,控制AC220V通断 |
power2 | String ("0"/"1") | 独立线路2 | 典型用于麻将桌插座 |
power7 | String ("0"/"1") | 独立线路7 | 部分型号支持更多路,可用于总控排插 |
point | JSON | 点动模式 | 继电器吸合一段时间后自动断开,专用于门禁。例:{"relay":[9],"interval":1000} |
play | String | TTS语音播报 | 支持中英文混读,编码为play:gbk:16 |
六、 总结
高集成度:相较于传统方案(WiFi通断器+独立门禁控制器),芯步的包间控制器将7路继电器、门禁电源、语音喇叭集成于一体,布线简单,故障点少。
真正的独立控制:物理触点隔离,7路输出互不干扰。即使照明线路短路跳闸,也不影响麻将桌运行和门禁系统。
极速响应:基于HTTP接口,实测局域网内响应时间在80ms-120ms之间,用户扫码后门锁即刻弹开,体验流畅。
私有化部署支持:芯步支持私有化部署,可将API服务器部署在门店本地局域网,即使外网断开,包间内的本地联动(如本地场景开关)依旧有效。
通过上述方案,开发者仅需调用几个简单的HTTP接口,即可快速实现共享棋牌室的门禁与多路照明的无人化智能管理。