共享棋牌室的智能化改造中,“双路控制”是一个常见但容易被忽视的痛点——比如进门时同时开启照明和换气扇,或者离店时延时关闭主灯排风。芯步的智能包间控制器通过HTTP接口可以灵活实现这类场景。以下方案聚焦如何用其开放接口完成双路设备的精准控制,并附实际场景代码示例。
1. 背景与需求分析
在共享棋牌室的无人值守运营模式中,双路控制是一个常见且关键的需求。所谓双路控制,通常指:
第一种场景(双路照明):一个包间内区分“主照明”(如吸顶灯)和“氛围/牌桌专用照明”(如吸烟灯),顾客扫码进门时自动开启主照明,开始计费时再自动开启牌桌专用灯。
第二种场景(照明+设备联动):顾客下单后,自动开启照明和空调/排风扇;订单结束后,延时关闭空调,再关闭照明。
第三种场景(双控开关):顾客既可以通过小程序远程关灯,也可以通过墙壁物理开关关灯,状态实时同步。
芯步的 智能包间控制器(Max/Mini) 提供了多路继电器输出接口,配合其开放的 HTTP API,能够完美实现上述需求,且无需网关,直接通过 Wi-Fi 2.4G 连接云平台。
2. 硬件选型与线路规划
为实现双路独立控制,我们选用 芯步 智能包间控制器|Max,理由如下:
多路独立输出:提供 8 路物理输出接口。其中第 1、2、3 路为 10A 开关,非常适合控制照明设备。
负载能力强:第 4、5、6 路为 16A 接口,适合接麻将机、饮水机;第 8 路为 30A 接口,专门用于空调控制。
对接简单:所有控制指令均通过 HTTP POST 请求发送,结构简单,易于与现有的小程序或 SaaS 后台集成。
硬件接线方案(针对双路照明)
| 设备接口 | 对接电器 | 控制目的 |
|---|---|---|
| 输出线路 1 (L1) | 包间主照明灯(LED吸顶灯) | 总亮度控制,进门即亮 |
| 输出线路 2 (L2) | 麻将桌专用灯/吸烟灯 | 游戏区域辅助照明,开始计费时开启 |
| 输出线路 3 (L3) | 排风扇 | 通风换气 |
| 零线/火线 | 220V 市电输入 | 设备供电与回路闭合 |
注:若仅需控制灯组,推荐使用单火线接入方式,无需改动现有墙面开关。
3. 接口对接逻辑与技术实现
芯步的开放接口基于 HTTP 协议,这是目前 Web 开发中最通用的标准。开发者只需在代码中发起网络请求,即可控制千里之外的硬件。
3.1 接口基础信息
请求地址
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}请求方法:POST
数据格式:JSON
核心鉴权:URL 中的
AppID、sign(签名)和ts(时间戳)用于验证商户身份,防止恶意篡改。
3.2 双路控制代码示例
假设我们要实现“智能情景模式”:顾客下单成功后,系统自动 开启 L1(主照明)+ L3(排风),但暂不开 L2(牌桌灯) ;当顾客点击“开始游戏”按钮时,再开启 L2。
步骤一:初始化/订单开始(下发开启 L1 和 L3)
此命令执行后,包间主灯亮起,排风扇运转。
步骤二:顾客主动开启双路照明(开启 L2 牌桌灯)当顾客扫码支付了麻将机费用或点击“开台”后,系统发送指令开启第2路:
步骤三:(高级功能)延时双控 - 离店自动关闭共享棋牌室常有“超时断电”需求。假设订单结束后,需要先关闭牌桌灯(L2),5分钟后再关闭主照明(L1)和排风(L3),以便顾客安全离开现场时。
这需要利用控制器的 先断后通 (Reset) 或 定时任务 功能。芯步接口支持直接在指令中设置 interval 间隔参数来实现自动化延时关断。
4. 拓展场景:传感器与双路联动
为了实现更智能的节能,可以将 芯步 智能人体存在传感器 纳入系统。
逻辑:当传感器检测到包间无人,但照明设备(L1)还开着时,系统自动执行关灯指令。
实现:传感器通过 HTTP 将状态消息推送到商户服务器,服务器写一个简单的
if判断逻辑,自动调用上述的控制接口。
5. 实施步骤和需要注意的点
设备配网:使用微信小程序搜索设备 Wi-Fi 热点,将控制器连接到门店的 2.4G 网络中。
获取凭证:在芯步开放平台注册账号,获取
AppID和AppSecret,用于生成动态签名sign。状态同步:利用设备的 状态上报 功能。当顾客使用物理墙壁开关切断了电源时,硬件会主动推送状态变更到你的服务器,避免出现“APP显示开、实际灯已关”的状态不同步问题。
安全隔离:虽然接口支持直接控制强电,但在接线时请一定要确保线路 L1/L2 所接灯的总功率不超过继电器的额定负载(2200W 阻性负载)。
6. 总结
通过对接芯步智能包间控制器的开放接口,开发者仅需掌握基础的 Batch(批量) 和 Reset(延时复位) 指令,即可在共享棋牌室中灵活实现复杂的双路照明及设备控制逻辑。这套方案的优势在于 硬件一体化(无需自行组装强电控制柜)和 接口标准化(普通 HTTP 请求可轻松集成),是降低无人值守运维成本的有效技术手段。