CATALOG

共享台球厅的痛点是:顾客扫码开台后,需要自动开灯、开电源;时间到了自动断电;老板远程也能随时控制。这里的关键就是解决“多线路集中控制”的问题。

芯步的 8路智能分体远程多通道控制箱(产品型号UNI-KZQ-TY-8),天生就是为这种场景设计的。下面是具体的对接思路和操作方案。

一、为什么选8路?先聊聊台球厅的痛点

咱们开台球厅的,最怕什么?最怕顾客一屁股坐下去,灯也不开,空调也不关,或者超时了还在那儿蹭着不打。传统的靠服务员吆喝、拿钥匙去关电,太落后了。

现在的共享模式讲究的是“无人值守”。顾客小程序一点,灯亮了;时间一到,啪,自动断电。

这里有个问题:一个台球厅少说4张台、8张台。“一张台球桌对应一路控制”是最理想的状态。如果你用那种单路的插座,一个球桌后面挂一个设备,那机柜里能乱成蜘蛛网,维护起来想死的心都有了。

而咱们今天聊的这个 “8路智能控制箱” ,它相当于一个 “排插总管” 。一个设备,直接管8张台(或者一个大包厢里的8路灯具/电源),干净利落。

二、这玩意长啥样?怎么接线?(实物视角)

这个8路控制器,说白了就是一个带联网功能的 8路继电器

简单翻译一下:继电器就是开关。它有8个“通道”,对应8个开关。你从家里接一根220V的火线进去,它内部帮你分成8路出来

  • 输入端:接总火线(L)、总零线(N)。

  • 输出端:有8个接线柱(OUT1 到 OUT8)。

  • 接法:你把球桌上方的灯的火线剪断,一头接到OUT1,一头接到灯的进线。这样,OUT1闭合,灯亮;断开,灯灭。

物理安装把这个箱子挂在吧台机房或者弱电井里,别挂在球桌旁边。因为它是集中控制,所有的电线都汇聚到这里。只需要一路网线(或者WiFi)给它通网,它就活了。

三、核心环节:怎么用代码控制它?(开发者看这里)

芯步的东西好在哪里?好在它的 HTTP API接口 是开放的,不管你后台用Java、Python还是PHP,甚至是用Excel的VBA都能调

我们不搞复杂的,直接用最通俗的 HTTP请求 来说话。

1. 先做准备工作(找钥匙)

在芯步的后台,你会拿到三个关键字符串,这三样东西缺一不可:

  • AppID:相当于你的用户名。

  • AppSecret:相当于你的密码(这个要藏好,别泄露了)。

  • Device ID:就是你这台8路控制箱的身份证号。

2. 控制一盏灯亮起来(举个栗子)

假如你在后台,看到顾客付了钱,选了“1号台”。你需要把接在 OUT1 上的那盏灯打开。

这个时候,你的小程序/后台系统需要向芯步的云平台发一条指令。

  • 请求地址https://api.thingboot.com/{你的AppID}/device/control/

  • 请求方法: POST

  • 请求内容(Body)

解读一下

  • device:告诉系统你要控制哪台机器。

  • order:你要下什么命令?

    • power1 代表 第1路

    • : 1 代表 打开(如果是 : 0 就是关闭)。

就这么简单,你发一条这个,1号台灯就亮了。

3. 那关灯或者批量控制呢?

  • 关掉第3路:发送 {"power3": 0}

  • 老板查房,把所有灯全关了:发送 {"batch": 0} (batch是批量的意思,0是关,1是开)

四、进阶操作:解决“卡单”和“超时”问题

在实际经营中,会遇到网络延迟或者顾客手机卡顿的情况。这里有个小技巧:结合本地逻辑

虽然HTTP接口是云端的,但芯步这套设备支持 “定时任务”“场景联动”

场景:顾客买了一个小时,时间到了怎么办?

方案A(推荐):业务逻辑后台下发指令在你自己的系统中设置定时器。计时结束 -> 触发后端代码 -> 调用上面提到的API -> 发送 power1:0

方案B:利用设备的“extra”特性防抵赖有时候网络波动,命令发出去了,设备没收到怎么办?芯步的接口支持一个叫 extra 的参数你可以这样发:

这样,无论设备什么时候执行成功,云端推送给你的消息里会带着你这个 order_123456 的订单号。你收到回调确认了,才给数据库写“已开台”。这保证了订单状态和设备状态绝对同步,避免顾客付了钱灯没亮,或者灯亮了没扣钱的纠纷。

五、私有化部署:如果你的台球厅没外网

有些台球厅开在地下室,或者WiFi信号极差,这时候还要去调公网API,延迟会很大。

芯步的这个设备支持 “局域网控制”“私有化部署”这意味着什么?意味着你搞一台破电脑甚至树莓派,在局域网里跑个服务,直接给设备发指令。不需要经过外网,那速度简直就是毫秒级的,顾客扫码的瞬间灯就亮了,体验极好。

操作如下

  1. 让控制箱和你的服务器连在同一个路由器下。

  2. 你的服务器直接通过局域网IP(比如 192.168.1.x)请求设备,而不是去请求 api.thingboot.com

  3. 这样不仅快,而且就算宽带的网线断了,你的台球厅内部依然能正常开关灯,不影响营业。

六、总结一下对接流程

别把这事儿想复杂了,总共就三步:

  1. 物理接线:把8张台(或8个区域)的灯线/电源线,分别接到8路控制箱的继电器输出端。

  2. 配网上云:用芯步的小程序给设备配网,让它连上WiFi,保证在后台能看到设备状态是“在线”。

  3. 写代码调API:在你的“共享台球系统”里,用户点击“开台/结账”的代码旁边,加上几行 curl 或者 requests 代码,发个POST请求,里面带上 power1:1power1:0

搞定。这就是所谓的“多线路集中控制”,其实就是一个8路控制器几行API代码的事。

一句话总结:你就把这个8路控制器当成你的 “远程机械手” ,你只要教会你的小程序在这个网址发这个命令,它就知道该掰哪个开关了。