CATALOG

共享麻将馆的智能化改造,关键在于门禁与照明的联动逻辑——用户下单后自动通电、离开现场时后自动断电,同时还要支持两路独立控制(比如照明一路、麻将桌插座一路)。芯步的开放接口通过HTTP协议即可实现这套逻辑,以下是具体方案。

解决方案:基于芯步开放接口的共享麻将馆门禁照明联动系统

一、 背景与需求分析

在共享麻将馆的无人值守模式中,痛点是远程控制能耗管理。经营者需要确保用户下单后自动通电,离开现场时后自动断电,且不同设备(照明、麻将桌、空调)需独立控制以避免浪费。

要实现“2路独立线路控制”,通常指:

  1. 第1路(照明/氛围线路):控制室内灯光、灯带。

  2. 第2路(插座/麻将桌线路):控制麻将桌、饮水机或换气扇。

  3. 门禁联动:控制电磁锁或电插锁,实现扫码开门。

芯步的开放平台通过其标准HTTP接口,可完美实现上述三者的逻辑联动与物理隔离控制。

二、 硬件选型方案

基于芯步产品线及共享场景特性,推荐使用 “智能包间控制器” 作为核心控制单元。该设备专为服务型门店设计,支持 WiFi/4G 通信,无需网关

  • 推荐设备:芯步 智能包间控制器(服务版)

  • 选型理由

    • 多路独立输出:该控制器拥有多达7路独立控制接口,我们可选用其中2路实现需求:

      • 线路1 (照明控制):接入室内主照明、氛围灯带。通常支持power1指令。

      • 线路2 (设备控制):接入麻将桌电源插座、饮水机。通常支持power2指令。

    • 门禁直连:自带1路门禁接口(NC/COM干接点),可直接控制磁力锁或电插锁。

    • 语音播报:自带TTS语音功能,可在订单开始/结束时自动播报提示

(注:如装修已预留传统开关,亦可选用芯步的 2路WiFi墙壁开关 ,通过API控制火线通断。)

三、 系统架构与接口逻辑

芯步开放接口基于 HTTP 协议,采用 设备端直连云端用户端通过云端中转 的策略。架构如下:

  1. 用户端(小程序/APP):用户扫码请求开门。

  2. 业务云端(您的服务器):验证订单状态,向芯步云平台发起HTTP POST请求。

  3. 芯步云平台:通过MQTT/HTTP推送指令至包间控制器。

  4. 执行端(智能硬件):控制器解析指令,执行继电器吸合,通断220V电路。

核心API接口设计如下:

  • 接口地址http(s)://api.thingboot.com/{AppId}/device/control/

  • 请求方式:POST

  • 鉴权方式:URL携带签名(Sign)、时间戳(ts)

四、 联动控制流程实现

以下是实现“门禁照明2路独立控制”的具体业务流程:

1. 用户下单与授权

用户在平台下单后,服务器记录订单开始时间。此时,用户点击“开门”按钮,服务器向芯步接口下发命令。

  • 命令示例(开门+全开)服务器需同时下发门禁(持续通电5秒)和线路通断指令。

2. 使用中独立控制

在包间使用过程中,用户可能需要关闭灯光(打麻将时关灯只看牌)但不断麻将桌的电。通过小程序调用接口即可实现独立控制:

  • 关闭照明(独立控制)

  • 开启排风扇(如接在第3路)

3. 订单结束与全断

用户点击“退场”或订单计时结束,服务器需执行断电并锁门逻辑。为了防止用户还在包间内突然断电,通常配合雷达传感器检测无人状态执行

  • 命令示例(全断)

  • 语音提醒:在执行断电前30秒,下发TTS语音播报,提升体验。

五、 关键接口参数详解(依据官方文档)

为确保开发顺利,需注意芯步接口中的特定参数定义

参数指令数据类型对应功能说明
power1String ("0"/"1")独立线路1典型用于照明,控制AC220V通断
power2String ("0"/"1")独立线路2典型用于麻将桌插座
power7String ("0"/"1")独立线路7部分型号支持更多路,可用于总控排插
pointJSON点动模式继电器吸合一段时间后自动断开,专用于门禁。例:{"relay":[9],"interval":1000}
playStringTTS语音播报支持中英文混读,编码为play:gbk:16

六、 总结

  1. 高集成度:相较于传统方案(WiFi通断器+独立门禁控制器),芯步的包间控制器将7路继电器、门禁电源、语音喇叭集成于一体,布线简单,故障点少

  2. 真正的独立控制:物理触点隔离,7路输出互不干扰。即使照明线路短路跳闸,也不影响麻将桌运行和门禁系统。

  3. 极速响应:基于HTTP接口,实测局域网内响应时间在80ms-120ms之间,用户扫码后门锁即刻弹开,体验流畅

  4. 私有化部署支持:芯步支持私有化部署,可将API服务器部署在门店本地局域网,即使外网断开,包间内的本地联动(如本地场景开关)依旧有效

通过上述方案,开发者仅需调用几个简单的HTTP接口,即可快速实现共享棋牌室的门禁与多路照明的无人化智能管理。