这是一个关于芯步4路智能包间电源控制器MINI的开放接口对接与自定义联动解决方案。
我们将围绕“传感器触发”、“业务系统逻辑” 和 “TTS语音播报” 三个核心维度，讲解如何通过HTTP接口打破硬件孤岛。
1. 准备工作与核心思路
首先，我们要明白这个MINI控制器的“灵魂”在哪里。它不仅仅是一个可以用手机开关的插座，关键在于它开放了本地/云端的HTTP API接口。
核心逻辑链路：传感器/业务触发 -> 你的服务器/小程序 -> 调用芯步开放API -> MINI控制器执行动作(开关/播报)
只要你的软件系统能发HTTP请求，就能让MINI控制器执行你想让它做的事，无需复杂的嵌入式开发。
2. 开放接口的几个关键玩法
MINI的控制接口地址为：https://api.thingboot.com/{AppID}/device/control/
调用时需要三个关键凭证：从后台获取的 AppID、AppSecret，以及动态生成的 Sign 和 ts。
玩法一：独立控制每一路（基础联动）
API下发格式为JSON。比如你要实现“客人下单后，自动开灯、开麻将机”：
控制照明（第一路）：
{"power1":1}（1=开，0=关）控制插座/麻将机（第二路）：
{"power2":1}控制门禁锁（第三路）：
{"power3":0}（例如结账后断电开锁）控制空调（第四路）：
{"power4":1}
玩法二：批量控制与模式切换（场景联动）
这非常适合自定义联动。比如设置一个“离开现场时清洁模式”和“迎客模式”。
一键全断（离开现场时）：
{"batch":{"power":0}}自定义组合（迎客）： 只开灯和空调，不开麻将机，命令为：
{"batch":{"relay":[1,4],"power":1}}
玩法三：TTS语音播报（听觉联动）
如果你的MINI是TTS版本，它能直接把文字转成语音播报。联动逻辑为：前台操作 -> 包间音响播报。
接口命令示例：
{"play:gbk:16":"尊敬的客人，您的加单已确认，请慢用"}应用场景： 配合雷达传感器或门禁，当客人进门时自动播报“欢迎光临”；或呼叫服务时直接播报“XX包间需要服务”。
3. 实战：搭建自定义联动场景
下面通过三个具体的“个性化”场景，教你怎么写代码逻辑。
技术前提： 你需要写几行后台代码（Python/Java/Node.js/PHP均可），负责接收事件并调用芯步的API。
第一种场景：人体雷达感应 + 电源控制（人来灯亮，人走断电）
硬件组合：MINI控制器 + 芯步人体存在传感器。自定义需求：由于MINI没有物理感应功能，通过云端联动实现感应控制。
对接逻辑
雷达传感器检测到“有人”，向你的服务器上报数据。
你的服务器通过API下发指令给MINI：
{"power1":1}（开灯/排气扇）。雷达传感器检测到“无人持续5分钟”，上报数据。
你的服务器下发指令：
{"power2":0}（关闭麻将机电源）。
第二种场景：自助扫码 + 通电（共享棋牌室/茶室标准流程）
硬件组合：MINI控制器 + 微信小程序。自定义需求：用户在小程序付完款，系统自动给对应的包间通电。
对接逻辑
用户支付成功，回调通知你的服务器。
你的服务器查询对应包间的
device ID。下发指令：
{"batch":{"relay":[1,2,4],"power":1}}（打开照明、麻将机、空调）。如果是TTS版本，额外下发：
{"play:gbk:16":"欢迎光临，祝您玩的开心"}。
计时结束前5分钟提醒
服务器定时任务触发。
下发：
{"play:gbk:16":"您的包间剩余时间不足5分钟，请注意续费"}。
时间到，强制断电
下发：
{"batch":{"power":0}}（全屋断电，门禁断电[第三路]上锁，让客人出不去需前台人工解锁或再次续费）。
第三种场景：紧急按钮或门禁联动（安全防护）
自定义需求：按下墙壁的物理开关，触发全屋断电。
对接逻辑：在MINI控制器的第3路（门禁/信号线）接入一个物理复位开关。
当按下紧急按钮，MINI的状态变了，如果你开启了“设备状态变化推送”，你的服务器会收到
power3变更的通知。你的服务器判断后，执行全屋断电逻辑，确保安全。
4. 一些小Tips（避坑指南）
在实际调试中，这几个细节容易让人困惑，提前告诉你：
关于签名算法官方用的是双MD5，这是很多卡住的点。公式
Sign = MD5( MD5(AppSecret) + ts )注意：是先MD5一次密钥，得到的32位小写字符串，拼接上时间戳，再MD5一次。不要直接把密钥拼在时间戳后面。关于感性负载MINI控制器的第1、2路接麻将机、吸烟灯属于感性负载，功率要留足余量（不超过500W），否则继电器容易粘连。
关于状态同步不要频繁轮询设备状态，芯步支持“反向推送”。在你的后台设置一个接收地址，当设备状态变了（比如客人用遥控器关了空调），平台会把变化实时推给你，这样你的数据库状态就是准的。
总结
对接芯步的MINI控制器，本质上就是调接口。
输入：传感器数据、支付回调、定时器。
处理：你的业务逻辑（判断什么时候该开，该关）。
输出：HTTP请求（携带正确的Sign，带上控制指令）。
只要打通这一条通路，这个小小的MINI盒子就不再是孤立的硬件，而是你整个智能化系统里的一个“执行手脚”——指哪打哪。