健身房私教包间控制：如何将智能 8 路包间控制器接入到软件项目中_解决方案

CATALOG

这是一个针对“健身房私教包间”场景的解决方案。我尽量写得详细且口语化，方便你直接拿去给老板汇报或用于开发参考。

一、解决什么问题？

现在的私教工作室或健身房包间，经常遇到几个痛点：

我们要做的，就是把普通的包间变成 “自助式智能屋” 。会员或教练通过手机小程序/APP，一键就能控制房间里的灯光、空调、电视、甚至香薰机。

要搞定这件事，硬件是 芯步的“智能包间控制器” （8路版本）。

为啥选它？理由很实在：

接口多（8路） ：私教包间通常需要的：照明灯（1路）、氛围灯带（1路）、空调（1路，需要大功率）、电视/音响（1路）、排风扇（1路）……8路完全够用，还能剩几路备用。
功率大：第8路专门设计了30A的大功率接口，直接接2匹的空调都没问题，不用外接交流接触器，省了不少布线功夫。
好接入：它支持标准的HTTP API接口。这就意味着，不管你的软件是用PHP、Java、Python还是Go写的，只要会发HTTP请求，就能控制它。
联网简单：支持WiFi（2.4G），只要包间有WiFi信号，通上电就能连上。

简单来说，这玩意就像一个8位的智能排插，只是它的每一个开关都可以通过网络独立控制。

芯步的开放平台是免费的，这一点对创业公司很友好。

去芯步开发者后台注册，拿到两个关键东西：AppID 和 AppSecret（相当于你家大门的钥匙和密码）。

首先需要给控制器连上网。这个过程通常会让设备进入配网模式，通过AP配网或蓝牙配网，让设备连上健身房的WiFi。连上网后，设备会拿到一个唯一的设备ID，这个ID就是我们软件后面要控制的“门牌号”。

芯步的接口为了安全，要求签名。虽然有点烦，但其实就是按照规则拼字符串，然后取MD5。官方规则是：sign = md5(md5(开发者密码) + ts)。口语化解释：把你后台的密码MD5加密一次，再加上当前的时间戳，再整体MD5一次。这样能防止别人在网络上抓包搞破坏。

在你的后端服务中，封装一个“控制设备”的方法。

请求地址https://api.thingboot.com/{你的AppID}/device/send/ （大概这个路径，具体看文档）
必须带的参数
- device_id：要控制的那个设备的编号。
- key：控制第几路？比如 key=1 代表第一路灯。
- status：开还是关？ 1 代表开，0 代表关。
- ts：当前时间戳。
- sign：上面算出来的签名。

举个“关灯”的例子（伪代码思路）

单纯的接口调用太初级，我们要做的是场景化。在你的软件系统里，建立几个“触发器”：

第一种场景：一键开店/开课
- 触发：前台在系统里点击“分配包间”，或者教练刷脸进入。
- 执行：调用API，第1路照明开（50%亮度），第8路空调开（26度制冷），第4路新风开。
- 体验：会员一推门，房间灯光明亮，温度适宜。
第二种场景：一键下课/打扫
- 触发：教练在APP点击“下课”。
- 执行：关闭空调、电视、照明。只保留一路“保洁插座”（吸尘器用）或一路“消毒灯”。
- 30分钟后：如果无人使用，彻底切断总电源（除WiFi模块外），实现零耗电。
第三种场景：计时收费
- 如果你的私教包间是按小时出租的。会员下单后，系统生成一个临时授权码。
- 会员扫码进入，系统自动通电。会员离开时点击退场，系统检查设备状态并断电。
- 如果超时未续费，系统自动切断空调电源，只留照明，提醒用户时间到了。

因为私教区通常是独立空间，为了稳定，混合架构：

关于空调：普通的智能开关扛不住空调的瞬间电流。一定要用8路控制器上的第8路（30A继电器），或者加交流接触器，否则开关会粘连甚至起火。
关于门锁：如果是全自助的24小时健身房，第7路专门用来接门禁磁力锁。可以实现在线开门，配合人脸识别门禁。
不要轮询：千万不要前端每隔1秒就去查一次设备状态，API有限流（1次/秒）。要用MQTT方式（长连接）监听设备状态变化，或者只在用户点开页面时刷新一次。