这是一篇关于如何将芯步“4路远程包间电源管理模块MINI”集成到你自有项目中的解决方案。我将尽量写得详细且通俗易懂，方便你的开发团队快速上手。

1. 先认识一下这个“小盒子”

我们要打交道的硬件全称叫 智能包间控制器Mini（UNI-KZQ-BJ-MINI）。你可以把它理解成一个装在包间里的、能联网的智能配电箱。

它长得很小巧（72mm宽，跟一张扑克牌差不多长），但本事不小，专门为共享棋牌室、茶室、自习室这类服务型门店设计的。

这4路分别能干什么？这个盒子内部有4个继电器，对应4路输出，每一路你都可以当成一个智能插座来用，通过接口独立控制开关：

• 第1路：16A，一般是接照明、换气扇、吸烟灯这类常开设备。

• 第2路：16A，接饮水机、麻将机、按摩仪这种大功率电器。

• 第3路：10A，这是专门预留的门禁电磁锁接口（直流）。

• 第4路：30A，专门用来接2匹以下的空调。

2. 接入前的准备

动手写代码之前，需要先让硬件“上网”并拿到身份凭证。

1. 硬件接线：给盒子接上220V电（注意：第3路门禁锁是直流，别接错），然后用手机给它配网。这个盒子只支持 2.4G WiFi，不支持5G。

2. 获取凭证：登录芯步的控制台。

   • AppID：你的“项目身份证”。

   • AppSecret：你的“项目密码”，用来算签名。

   • Device ID：设备的唯一ID，贴在盒子外壳上，或者在后台能看到。

注意：这个设备支持私有化部署和局域网纯环境运行。如果你有内网服务器，可以架设私有MQTT或HTTP服务，数据完全不出机房。

3. 核心玩法：如何发指令？

它的接口极简，就是个标准的HTTP POST请求。不管你是用Java、Python、PHP还是Node.js，或者前端Vue/React，只要你能发POST请求，就能控制它。

接口地址示例POST https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}

请求体（Body）

重点讲一下签名

签名机制是为了防止有人随便调用你的接口。规则是：sign = md5( md5(AppSecret) + ts )

简单说就是：把你后台的AppSecret加密一次，然后拼接上当前的时间戳，再加密一次。

4. 实战：那些必用的命令

只要掌握了下面这几种 order（命令）的写法，你的项目就算通了。

第一种场景：单独开关某一路

这是最常用的。

• 开第1路（比如开灯）{"power1": 1}

• 关第2路（比如关麻将机）{"power2": 0}

• 开门禁锁：第3路一般接的是门锁（常闭型），通电开锁。{"power3": 1}

第二种场景：一键全开 / 全关

顾客下钟了，要打扫卫生或切断电源

• 全关{"power": 0}

• 全开{"power": 1}

第三种场景：批量控制（只动其中几路）

我想只关掉灯和麻将机，但不断空调{"batch": {"relay": [1,2], "power": 0}}

场景四：进阶玩法——“点动”模式

点动：先通电，过几秒自动断电。应用场景：打开电插锁开门（通电解锁1秒，然后自动断电，防止锁体烧坏）。

命令：{"point": {"relay": [3], "interval": 1000}}（解释：对第3路通电1000毫秒（1秒）后自动断开）

5. 代码实操：用PHP举个简单的例子

假设你要在你的后端处理“开门”请求（PHP版本）：

（其他语言的类似写法，如Node.js、Python、小程序等都可以参考这个逻辑）

6. 一些避坑指南

1. 关于TTS语音版：如果你买的是带TTS的版本，还可以让盒子说话。命令示例：{"play:gbk:16":"欢迎光临，请刷卡进门"}。非常适合做迎宾语音播报，或者提示“设备已断电，请扫码续费”。

2. 响应速度：走公网API的话，延迟通常在100ms-500ms之间，开关门锁完全够用。如果是局域网控制，几乎是秒开，内网环境就不怕断网了。

3. 负载安全：虽然第4路能支持6600W，但单路长时间负载不要超过额定功率的80%，给线路留点余量。

总结

把芯步的4路控制器接入你的项目，本质上就是 拿着Key (AppID/Secret) 去开门 (调用API)，然后把指令 (Order) 丢给指定的人 (Device)。

你只需要写好后台的API调用函数，前端只需要负责调用你后台的接口就行了，硬件层的复杂度被完全屏蔽了。剩下的就是根据你的业务逻辑来写代码了，比如用户支付成功后自动通电、预约时间到点自动通电等。