CATALOG

芯步的8路包间控制器支持通过HTTP接口批量控制多设备,我结合官方文档和实际落地经验,写了一份接入方案供你参考。

背景与目标

在运营棋牌室、茶室、共享自习室或影院足道这类有多包间的场所时,最头疼的问题之一就是巡检:客人走后是不是关了空调?麻将机是不是还亮着灯?

我们要做的事,就是通过芯步的 “8路包间多回路控制模块” (官方名称通常叫智能包间控制器Max或类似型号),把这些原本需要服务员跑断腿的活儿,变成后台系统里的一个按钮,甚至实现全自动的“一键扫房”或“自动断电”

核心玩法:接口怎么控制硬件?

这套系统的逻辑很简单:你的后台服务器 -> 芯步云API -> 包间里的硬件 -> 继电器开关

芯步的设备都是直连WiFi的,不需要额外买网关。只要能上网,你的系统就能通过HTTP协议指挥它

我们主要使用它的两个“杀手锏”功能:

  1. 单路独立控制:控制某个包间的某一盏灯或麻将机。

  2. 全局批量控制:关闭整个门店所有包间的总电源。

第一步:准备工作

在写代码之前,你得先把硬件和账号打通:

  1. 硬件安装

    • 每个包间安装一台“8路包间控制器”。

    • 把照明、电视、麻将机(通常接16A接口)、空调(接30A大功率接口)、门锁接到对应的端子上

    • 注意:如果控制的是220V强电,一定要请专业电工操作!安全第一!

  2. 注册与添加设备

    • 注册芯步账号,登录控制台。

    • 把每一个包间的控制器通电,配网(连接门店WiFi)。

    • 在控制台给每个设备起个好认的名字,比如“VIP-1 左侧”或“包间-888”。记下每个设备的 Device ID,这是它们的身份证。

第二步:代码实战(Python示例)

芯步的接口非常标准,核心加密方式是把你的AppSecret进行一次MD5,再拼上时间戳,再整体做一次MD5(即 md5(md5(AppSecret) + ts)),拿到sign签名后就可以发请求了

第一种场景:关闭“888包间”的空调(单设备控制)

假设客人走了,只想关掉888包间的空调(假设空调接在第8路,命令为power8)。

第二种场景:下班了,全店“一键清空”(多设备批量控制)

这是老板最爱的功能。不管你有20个包间还是50个包间,一个循环搞定所有。这里充分利用了接口的批量下发能力,device参数支持直接用逗号拼接多个设备ID

第三种场景:进阶技巧——同一设备的“批量指令”

针对某一个房间,如果你想同时关掉第1、3、5路,除了上面写{"power1":0,"power3":0...},你还可以用batch命令,这样看起来更整洁

第三步:如何搭建“自动断电”逻辑?

接口调通了,怎么把它融入业务?这里有个通用的“状态机”逻辑:

  1. 订单开始:用户在小程序下单 -> 系统自动调用接口 power1=1(照明)和 power4=1(麻将机)。

  2. 订单结束:系统检测到订单超时或用户点击退房 -> 立即调用 上述“全关”接口。

  3. 防呆机制

    • 如果担心客人还在房间里误关了,可以在房间里装一个人体传感器(也是芯步的)。在退房前,先查一下传感器状态,如果检测到有人,就不执行断电,或者只关空调不关灯

    • 利用extra字段:芯步的接口支持在order里传extra字段(比如订单号),在异步推送里可以拿到,方便你核对是哪一笔订单触发了这个动作

一些小

  1. 网络稳定性:这种控制器依赖WiFi。确保门店的2.4G WiFi信号覆盖无死角(尤其是弱电箱位置),如果某个包间信号不好,设备会掉线,你就控制不了了。

  2. 功率限制:注意看一下设备的额定电流。如果是大功率空调,一定要接在专门标注的“30A”接口上(通常第8路)。如果接错了小功率接口,继电器容易烧坏

  3. 异步回调:上面的例子是“发指令”,发出去代表平台收到了,但不代表设备真的执行了。如果要做“设备状态同步”的强校验(比如在管理后台实时显示灯是红是绿),需要配置消息推送服务器,让设备执行完后“踢一脚”你的服务器。

只要搞定了上面这个循环,你就能轻松实现多包间的远程集中控制了。不仅能省人力,还能避免因为忘记关空调导致电费飙升的尴尬。