4路共享空间智能控制器MINI是专为棋牌室、茶室、自习室等场景设计的核心管控设备，其开放HTTP API接口支持开发者实现精细化设备联动。以下方案涵盖接口能力、签名机制、核心命令及典型联动场景的实现逻辑。

解决方案：基于芯步4路智能控制器MINI的自定义联动系统开发

1. 产品概述与核心能力

设备型号： UNI-KZQ-BJ-MINI （含TTS语音版）核心作用： 作为共享空间（如棋牌室、茶室、自习室、琴房）的“大脑”，控制包间内所有强电设备。

4路输出定义：

• 第1路（16A）： 照明、换气扇、吸烟灯。

• 第2路（16A）： 麻将机、饮水机、按摩仪。

• 第3路（10A）： 门禁电磁锁/电插锁（控制房间门开关）。

• 第4路（30A）： 2匹空调（高负载专用）。

开放接口优势：

• 协议支持： HTTPS/HTTP（支持公网和局域网）。

• 鉴权方式： MD5双重签名。

• 响应速度： 下发至执行平均 80-120ms。

• 核心API能力： 单路控制、批量控制、定时任务、语音播报（TTS版）、状态查询。

2. API接入与鉴权准备

在开始自定义联动开发前，需先完成开发者凭证配置。

步骤 1：获取凭证登录芯步控制台，获取 AppID 和 AppSecret。

步骤 2：签名计算（核心安全机制）所有API请求需携带签名 sign 和时间戳 ts，防止接口被恶意篡改。Sign 生成公式：Sign = MD5( MD5(AppSecret) + ts )

（注：“+” 表示字符串拼接；ts 为 Unix 时间戳，单位秒）

步骤 3：请求地址POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

3. 核心联动指令详解

为了实现“自定义联动”，你需要熟悉下发 order 参数的JSON结构。

3.1 基础单路控制

控制第1路照明开启，第2路麻将机关闭：

3.2 时序控制（实现“无人断电”与“临时通风”）

通过时序命令，可以避免因软件逻辑Bug导致设备一直开启，在联动中高频使用。

• 先通后断 (point)： 开启一段时间后自动关闭。场景： 用户下单后，自动开灯并换气30秒，随后自动关闭以节能。指令：{"point":{"relay":[1,2],"interval":30000}} （第1、2路开启30秒后自动关闭）。

• 先断后通 (reset)： 关闭一段时间后自动重启。场景： 路由器或设备死机重置；门锁先断电再通电复位。

3.3 批量与场景控制

用户下单“包夜模式”时，需一键配置空调、照明、麻将机。

3.4 TTS语音联动（仅TTS版本）

设备收到指令可立即播报语音，适用于订单播报、服务提醒。

• 指令示例：{"play:gbk:16":"欢迎光临，主人，房间设备已就绪，祝您体验愉快"}

4. 实战：自定义联动场景搭建

假设你有一套自己的SaaS系统（或Node-RED/HomeAssistant），以下是典型场景的代码逻辑实现。

第一种场景：用户下单 -> 自动开房（门禁+设备联动）

逻辑： 用户支付成功后，系统自动开启指定包间的门锁（第3路），并打开灯光（第1路），同时播报欢迎语。

第二种场景：无人值守 -> 自动断电与计费结束

逻辑： 用户点击“结束订单”或雷达传感器检测无人超过10分钟，系统立即关闭空调（第4路）、麻将机（第2路），并强制关闭门锁。

第三种场景：定时任务与传感器联动（高级）

结合芯步的人体传感器，实现“人来灯亮，人走灯灭”的节能控制。

1. 接收传感器数据： 配置您的服务器接收设备上报的 radar 状态。

2. 判断逻辑： 当 radar 状态变为 无人 且持续 300秒。

3. 执行联动： 调用控制器接口，{"power1": 0} 关闭照明。

场景四：设备死机自动运维恢复

逻辑： 监控系统发现路由器或麻将机离线/死机，通过控制第2路或第4路进行断电重启。

5. 本地局域网与私有化部署（低延迟方案）

对于要求高稳定性或纯内网的场景（如电竞酒店、内部机房），芯步Mini控制器支持局域网HTTP控制。

切换方式：

1. 在控制台配置设备为“局域网模式”。

2. 直接通过设备IP地址发送请求（绕过云端）：POST http://{设备局域网IP}/control/优势： 无公网延迟，不受外网断网影响。

6. 最佳实践

1. 功率分配： 空调请一定要接第4路（30A），切勿将空调接入第1/2路，否则可能烧毁触点。

2. 门禁安全机制： 控制门锁（第3路）时，使用 point 命令（通电1-5秒自动断），防止电磁锁长时间通电发热烧毁或损坏门禁控制器。

3. 重试机制： 网络环境复杂，调用API失败时，请建立随机间隔（或逐次增大间隔）重试机制（如失败后1秒、2秒、4秒后重试）。

4. 状态同步： 不要仅依赖本地内存记录开关状态，每次联动前可通过 GET /device/status/ 接口（若有）获取设备当前真实负载情况，防止重复下发。

通过上述方案，您可以基于芯步的开放API，将4路智能控制器MINI深度集成进您的业务系统中，实现从“订单支付”到“设备供电”的全自动化闭环管理。