CATALOG

共享台球室这种无人值守模式,痛点就是设备电源管理——用户下单后自动通电,时间到了自动断电,还得能在后台随时查看设备状态。芯步的通断器模块正好能解决这个问题,这篇文章我会一步步讲清楚怎么对接。

一、 为什么你需要这个“通断器”?

在共享台球室里,你最怕什么?怕客人扫了码,结果台球桌的灯不亮;或者客人时间到了走了,灯却忘了关,浪费电。

这个“智能通断器”说白了就是一个装在配电箱里的“智能开关”。你通过后台给它发指令,它就能把电闸“咔哒”一下合上或者拉开。

核心逻辑: 用户下单(小程序) -> 你的服务器(接到订单) -> 发出指令(给芯步云) -> 通断器执行(灯亮了)。

这样你就完全不用雇人守着开关了,全自动。

二、 准备工作:你手里要有这些东西

在写代码之前,我们得先把“硬件”伺候好,不然代码写得再好也控制不了。

  1. 买设备:去芯步买个“智能通断器”(通常也叫智能开关、继电器模块)。注意要买支持“开放接口”的版本,别买只能连App的那种

  2. 配网:这步很关键。设备装上后,用芯步的小程序或者App,把这个通断器连上你台球室的WiFi。这一步相当于给这个开关拉了一根网线,确保它能上网接收指令

  3. 注册开发者账号:去芯步的开放平台注册。在这里你会拿到两个最重要的东西:AppID(你的身份ID)和 AppSecret(你的密码,需要用来加密签名)。这俩是你控制设备的“钥匙”

三、 核心:怎么用代码控制电源?

这里我们主要用 HTTP 接口 的方式。不管你的后端用 PHP、Java、Python 还是 Go,原理都一样。

芯步的接口地址一般是这样拼出来的:http(s)://api.thingboot.com/{你的AppID}/device/control/

第一步:搞定签名

芯步的接口为了安全,所有请求都得带一个动态的 sign(签名)。如果不做这一步,接口会直接拒绝你。

签名的生成规则(非常标准,照着来就行):

  1. 拿到你的 AppSecret

  2. 拿到当前时间的秒级时间戳 ts

  3. 公式sign = md5( md5( AppSecret ) + ts )

举个例子:假设你的密码是 abc123,MD5加密后变成 e99a18c...,当前时间是 1712345678那么拼接后的字符串就是 e99a18c...1712345678,再MD5一次,就是你这次请求的 sign

为什么要这样? 为了防止别人伪造请求,每个时间戳对应的密码都不一样。

第二步:发送“开灯”指令

现在我们来写代码发指令。假设客人刚扫码支付了1小时,系统需要立刻打开台球桌上面的灯。

我们需要向服务器发送一个 POST 请求,带上以下参数:

参数名值示例解释
device1234567890你在控制台看到的设备ID,告诉系统你要控制哪一台。
order{"power":1}核心命令!power是属性,1代表接通/开,0代表关

实际发送的请求体大概长这样(JSON格式):

执行逻辑:如果你的服务器是 PHP 写的,就用 curl 发一下。如果是其他语言,逻辑完全一致。

如果你想让设备“延时关闭”(比如订单结束前5分钟闪一下,或者延时断电),可以传更复杂的参数,比如 delay 或利用 reset 指令

第三步:处理“掉线”和“超时”

你可能会遇到这种情况:接口明明返回 code 200(代表指令发过去了),但是灯没亮。原因很简单: 通断器虽然连了WiFi,但可能因为信号不好掉线了。200 只代表“平台收到了指令”,不代表“设备执行了指令”

解决方案:这时候你需要配置 消息推送(回调)去后台设置一个你服务器的 URL 地址。当设备真正执行了指令(比如确实关上了),芯步云端会主动给你这个地址发一个通知:“嘿,设备ID 123 已经成功断电了”

这样你就能在后台记录:“状态:设备已离线”或者“操作成功/失败”,方便客服处理客诉。

四、 怎么接入你的台球室小程序?

对于用户来说,他们不需要看到这些技术细节。下面是用户体验的闭环设计:

  1. 扫码启动:用户在小程序上点击“开始打球”,调用支付接口。

  2. 支付回调:支付成功 -> 你的后台收到微信/支付宝的回调。

  3. 执行开电

    • 后台组装上面提到的 signdevice 参数。

    • 调用芯步的 device/control 接口。

    • 传参 {"power": 1}

  4. 状态反馈:通断器接通电源,台球灯亮起,球桌照明通电,点球机通电。

  5. 计费结束:订单倒计时结束,或者用户点击“结束订单”。

  6. 执行断电:后台再次调用接口,传参 {"power": 0}。灯灭了,电磁锁吸合(如果是门的话),防止客人超时。

五、 几点避坑指南(大实话)

  1. 关于网络:通断器 只支持 2.4G WiFi。如果你的台球室用的那种5G/2.4G混合名称的WiFi,最好单独开一个 2.4G 的频段给它,否则设备经常连不上

  2. 关于本地局域网控制(进阶):芯步支持私有化和局域网控制。如果你觉得每次开关灯都要绕一圈云端(虽然很快),可以在局域网内部署。也就是你的服务器直接对着通断器的局域网 IP 发指令,不经过外网,速度更快,也更稳定,即便外网断了也能控制

  3. 设备ID别搞混:一个台球厅有七八张桌子,每张桌子配一个通断器。你需要在你自己的数据库里绑定好:设备ID_001 对应 1号桌。千万别发错指令,把1号桌的灯给3号桌开了。

  4. 关于费用:芯步的开放接口是免费的,主要是设备购买费用

总结一下

把芯步的通断器集成到你的项目里,本质上就是 调用一个 HTTP 接口

说白了就是三步:

  1. 拿到钥匙:去后台拿 AppID 和 AppSecret。

  2. 会算密码:按规则生成 sign。

  3. 发指令:对着接口 POST {"device":"xxx", "order":{"power":1}}

把这个逻辑写进你的订单流程里,你的台球室电源管理就算自动化了。

通断器产品方案:
自动化设备交流电源管理:怎么将2200W智能通断器AC1接入到软件项目中
查看 >>
普通灯具系统交流控制:怎样将智能通断器AC1-10A对接到自己的项目中
查看 >>
校园公共设备电源管理中:怎样把AC3-10A 计量版电源开关接入到软件项目中
查看 >>
共享麻将馆灯光插座管理:怎么将DC-10A 电器开关集成到自己的项目中
查看 >>
仓储设备电源控制:如何将AC4-30A 物联网开关对接到自己的项目中
查看 >>
电源场景方案:
自助售货机电源管理:怎样将AC1-10A电器开关集成到软件项目中
查看 >>
大功率设备电源管理:怎样将带计量智能断路器50A集成到项目中
查看 >>
企业机房机柜设备电源控制:怎么将8位智能分控PDU对接到软件项目中
查看 >>
餐厅设备机柜电源控制:怎样把8位远程控制PDU接入到软件项目中
查看 >>
如何在创客项目电源控制场景中接入智能设备以实现远程参数配置管理
查看 >>
远程用途方案:
怎么在普通灯具系统交流控制中接入智能设备来实现远程批量控制
查看 >>
如何二次开发40W 云 TTS 语音音柱来实现远程TTS语音播报
查看 >>
怎么在无人值守场所门禁照明管理中集成智能硬件来实现远程参数配置管理
查看 >>
如何在共享场所直流负载管理中接入智能硬件来实现远程批量控制
查看 >>
怎样在自动贩卖机通断电控制中接入智能设备来实现远程参数配置管理
查看 >>