这是一份关于“共享球场灯光电源控制”的解决方案。结合芯步的 AC1-10A 智能通断器,我帮你梳理了整个对接思路。我会尽量写得口语化、接地气一点,方便你直接拿去跟开发团队沟通或者做技术方案参考。
一、 痛点与需求:为什么球场需要它?
如果你是球馆老板或者共享球场的开发者,可能会遇到这种场景:订了晚上8点的场,用户来了发现灯没开;或者打完球走了,灯亮了一整晚,电费哗啦啦地流。
我们要解决的,就是“谁来开、谁来关、怎么收费联动”的问题。
简单来说,我们要把传统的“摁墙开关”,变成 “手机点一下/订单支付成功/扫码即用” 的自动化控制。
主角是 芯步的 AC1-10A 智能通断器(也叫智能继电器)。这玩意个头不大,直接装在球场原来的配电箱里,串联在灯光的回路上。
二、 硬件:AC1-10A 的“硬核”本事
先说说咱们手里这块硬件。
10A/16A 版本:对于球场照明(LED灯或者金卤灯)来说,完全够用,额定功率支持 2200W。
无网关直连:这玩意儿直接连 2.4G WiFi,不需要买那个什么“网关系列”,买回去接上线,配网就能用。
接口开放度:这是选它的重点。它支持 HTTP 接口 和 Websocket。说白了,不管你的后端是用 Java、Python 还是 Go,甚至前端写几行 JS 都能控制它。
三、 对接逻辑:一张图看懂流程
我们不要搞复杂了,只关注三个角色:
你的业务系统:比如小程序后端、订单系统。
芯步云平台:中间商(但免费),帮你转发指令。
AC1 硬件:球场里那个物理设备。
核心逻辑:你的系统通过调用芯步的开放 API,告诉云平台“去把那个球场的灯打开”,云平台通过 WiFi 推送给硬件执行。
四、 动手对接:分步详解
既然不要附件,那我就不贴大段代码了,直接说步骤和关键点。
第一步:设备配网与注册
拿到 AC1 后,接好线。先在手机上下载厂家提供的配网小程序。把设备加入到你的账号下。这时候你会拿到一个 Device ID(设备编号),这个 ID 就是你这盏灯的“身份证号”,记下来。
第二步:熟悉“签名”机制(稍微绕一点)
要控制设备,不能随便谁都能调接口,得有安全验证。芯步这边的签名算法比较标准,但第一次接触容易晕,我帮你白话翻译一下
你调用接口时,必须带三个参数:AppID、ts、sign。
AppID:相当于你的用户名。
ts:当前时间戳。
sign:这就是身份证。计算公式是:
md5( md5(你的AppSecret) + ts )。白话:先把你后台的密钥(AppSecret)加密一次,再加上当前时间,再整体加密一次。
避坑指南:很多同学第一次调不通,99% 是因为时间戳不对,或者没搞清楚拼接顺序。直接用官方给的 Demo 代码跑一遍,看通了你再移植。
第三步:下发控制命令
这是最爽的一步,代码量极少。只需要发一个 HTTP POST 请求。
接口地址https://api.thingboot.com/{你的AppID}/device/control/
请求体
发过去,如果返回 code 200,那灯就亮了。
针对球场的进阶玩法如果球场很大,多盏灯怎么办?
分组控制:你可以把所有“1号场”的灯设备 ID 存在数据库里。用户下单后,循环调用接口关掉?太Low了。
批量指令:传参时,
device参数支持用逗号分隔,比如device=id1,id2,id3,一条指令全亮。定时关灯:如果是按小时计费的,用户买了2小时,2小时后怎么自动关?可以在订单超时逻辑里调用关灯接口。也可以利用硬件的
reset指令,比如开灯的时候顺带说一句“60分钟后自动关”,防止程序崩了灯一直亮。
第四步:状态同步
用户要是自己去配电箱按了按钮把灯关了,你的系统不知道咋办?用 消息推送。你需要在后台设置一个 回调 URL。一旦设备状态变化,芯步的云平台会主动把你的地址:灯关了!灯开了!这样你的系统数据库里的状态就是准的,不会出现“系统显示开,实际灯灭”的尴尬。
五、 实际应用场景
假设你是共享球场的小程序开发者,你的代码逻辑大概是这样的:
场景:用户下单支付成功
动作:你的后端收到了支付回调。
代码逻辑:调用 AC1 接口,参数
{"power":1}。结果:球场灯亮起,用户进场。
场景:用户点击小程序内的“开/关”按钮
动作:前端请求你的服务器,你鉴权(确认是这个用户在操作)后,调用接口。
场景:订单结束
动作:计时结束,或用户点击“结束订单”。
代码逻辑:调用 AC1 接口,参数
{"power":0}。
六、 避坑与提示
供电问题AC1 需要零火线供电。球场的老配电箱里,如果只有火线(开关线)没有零线,那是装不了的。需要确认一下。
WiFi 信号一般球场很大,弱电箱可能在角落里。AC1 这种小模块的 WiFi 天线不如手机强。如果信号不好,经常掉线,用 WiFi 信号中继,或者选用带网口版本的网关产品。芯步虽然 AC1 是直连 WiFi,但如果距离太远,加个路由器桥接一下更好。
恢复断电测试一下“来电后设备状态”。如果晚上断电了,早上来电,灯是保持关还是自动亮?根据业务需求,在控制台设置好通电状态,避免白天浪费电。
接口免费他们的开放平台接口调用是免费的,不用怕被薅羊毛。
七、 总结
把 AC1 智能通断器 对接到你的共享球场项目里,其实就是三步:
配网拿 ID;
对着文档抄签名算法;
发一条带
{"power":1}的 HTTP 请求。
预算方面,几十块钱的硬件成本 + 一下午的开发时间,就能让你的球场实现“全自动无人值守”。现在就可以在芯步的控制台里申请一个 AppID 试一下了。