CATALOG

共享棋牌室的痛点是“无人值守”和“远程控制”,而芯步的2路智能墙壁开关正好能解决门禁联动和照明分控的问题。以下方案会详细说明如何通过HTTP接口把这台设备接入你的系统,实现用户一键开灯、自动断电等完整闭环。

1. 背景与选型分析

在共享棋牌室、自助茶室等无人值守场景中,痛点在于如何让用户在没有现场管理员的情况下,顺畅地使用特定房间的资源,并确保商家能远程管理设备。这要求硬件必须具备远程控制、状态反馈和高稳定性三大特性

针对“门禁+照明”这一基础且高频的联动需求,我们选择了芯步智能墙壁开关2路(型号:UNI-KG-2)。选型理由如下:

  • 双路独立控制:传统开关通常只能控制一路灯,而此设备拥有2路继电器。物理上“第1路”可接照明灯,“第2路”可接门禁锁的电源通断,或者一路接总照明,一路接麻将桌插座。这比使用两个单路开关更节省成本和底盒空间

  • 强电负载能力:额定电流10A,电压100-240V AC,足以应对棋牌室常见的灯具和电磁锁/阳极锁的负载需求

  • 开放HTTP API:这是芯步生态的核心优势。设备不依赖特定APP,只要能发送HTTP请求,无论是小程序、公众号还是PC管理端,都能轻松集成

2. 整体设计

我们将构建一个标准的三层物联网架构,确保数据流的顺畅与安全。

第一层:感知/执行层(硬件端)

  • 智能墙壁开关2路:安装在每个包厢的进门处,替代传统开关。

  • 磁力锁/电插锁:安装在包厢大门(需配合12V电源,开关的2路控制电源适配器的输入)。

  • LED照明灯:接在开关的第1路。

第二层:网络传输层

  • 设备配网:开关通过2.4G WiFi联网。由于棋牌室房间密集,需确保WiFi信号覆盖

  • 协议:采用HTTPS协议与云端通信,保障指令传输安全。

  • 私有化部署(可选):如果是大型连锁棋牌室对数据隐私要求高,芯步支持局域网直连和私有化部署,可将数据完全限制在商家自建的服务器内

第三层:应用层

  • 你的业务服务器:处理用户订单、鉴权、生成控制指令。

  • 商家管理端:查看设备状态、远程急停。

  • 用户小程序端:用户下单后,界面出现“开灯/开门”按钮。

3. 接口对接核心逻辑

芯步开放平台的接口设计非常简洁,主要分为两部分:主动下发指令被动接收状态

3.1 设备控制接口 —— 远程开关灯/开门

这是项目中最常用的功能。当用户在小程序点击“打开灯光”时,后台需调用此接口。

  • 请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 请求方法POST

  • 请求体示例 (JSON)

对应你的需求:控制照明

  • 逻辑扩展

    • 照明控制:用 "power1":1 控制第一路灯光。

    • 门禁控制:共享棋牌室常用的方案是“断电开锁”或“通电开锁”。通常磁力锁用“通电上锁,断电开门”(即点一下开关第二路断开,门锁断电1秒再闭合)。代码逻辑:用户点击“开门” -> 服务器发送 {"power2": 0} -> 延时1秒 -> 发送 {"power2": 1}。这样实现了类似门禁按钮的脉冲信号,门弹开后锁恢复常闭状态

3.2 设备状态同步与联动(核心体验)

智能硬件不仅是“遥控”,更是“感应”。你需要让系统知道设备当前是开还是关。

  • 方案A:轮询机制(适合初期)

    • 调用设备状态查询接口,每隔5-10秒获取一次设备当前状态。

  • 方案B:消息推送机制(推荐)

    • 在芯步控制台中配置你的消息接收服务器URL

    • 当用户物理按动墙壁开关时,设备会主动上报状态变化到你的服务器。

    • 联动场景:通过人体传感器(芯步生态产品)检测到“无人”状态,服务器自动向开关发送关闭指令,实现人走断电,节约电费

4. 业务场景实战:共享棋牌室的自动断电逻辑

如何利用该设备实现“订单开始才通电,订单结束就断电”的无人值守闭环?

场景流程:

  1. 用户下单:用户在微信小程序支付预定包厢费用,获得一个“启动包厢”按钮。

  2. 授权控制:后端调用接口,对客厅的2路墙壁开关发送指令:

    • {"power1": 1} (照明灯亮起)

    • {"power2": 1} (麻将桌插座通电/或解除门禁吸合)

  3. 使用途中

    • 用户可按墙壁开关关灯休息,关灯状态会通过消息推送同步到服务器,管理员可查。

  4. 订单结束/超时

    • 用户点击“退房”或系统判定时间到。

    • 后端调用接口:{"power1": 0, "power2": 0}

    • 结果:灯光熄灭,麻将桌断电(或门禁锁通电锁门),房间恢复空闲状态。

防误触机制与“一键场景”

棋牌室常有打扫卫生的需求。可以利用接口中的“状态锁定”功能。

  • 发送指令启用“童锁/常供电”模式:即使清洁人员关掉了墙壁开关的物理按键,软件后台可以设定线路保持通电状态,或者设定几秒后自动恢复,防止清洁人员误关总闸导致路由器掉线

5. 开发实施中的技术点

在实际代码接入中,有几个细节决定了项目的稳定性:

5.1 签名机制

所有请求都需要携带 sign 签名。不要把 AppIdAppSecret 写死在硬编码里,应放在后端环境变量中。签名算法通常是 md5(AppId + Secret + Timestamp) 的形式,防止重放攻击

5.2 局域网直连模式(应对断网)

共享棋牌室最怕断网导致无法开门。芯步设备的一个优势是支持局域网通信做法:在你的棋牌室前台或机房部署一台本地服务器(或树莓派)。当外网断开时,你的小程序后台可以切换内网IP,直接向同一局域网下的 http://[开关本地IP]/control 发送指令。这可以保证在任何情况下,核心的开锁/关灯指令都能够被执行

5.3 设备管理

在开发管理后台时,需要设计以下字段来管理硬件:

  • device_id:设备唯一ID。

  • room_id:关联的房间号。

  • wifi_signal:信号强度监控(低于-70dBm需提醒加AP)。

  • power1_status / power2_status:实时显示两路状态。

6. 总结

通过接入芯步的2路智能墙壁开关(产品ID参考:8619系类),你的共享棋牌室项目可以快速获得以下核心能力:

  1. 低成本改造:无需重新布线,直接替换现有86开关即可控制灯光和门锁/插座。

  2. 高自由度:通过开放API,硬件逻辑完全由你的业务代码定义,而非受限于某个APP。

  3. 高可靠性:支持私有化部署和局域网控制,解决了公网依赖问题,非常适合商业运营

你的开发团队直接参考芯步官方的 “开放平台” 文档中心,对照其中关于 “设备控制”“消息推送” 的章节进行联调,通常一周内即可完成基础联调上线。