这是一份针对芯步“4路远程包间管理控制器MINI”的对接解决方案。本方案的目标是帮助开发者或技术决策者理清对接流程、技术要点以及如何在业务系统中实现深度集成。

1. 项目概述与对接价值

在共享棋牌室、茶室、自助自习室及琴房等无人值守服务场景中，远程控制电器的通断是实现自动化运营的核心。芯步推出的 “4路远程包间管理控制器MINI” （型号：UNI-KZQ-BJ-MINI）是一款专为包间设计的嵌入式智能硬件。

本方案的目标是解决开发者如何通过标准HTTP API接口，将该硬件快速集成到现有的Web、小程序或APP软件项目中。对接完成后，您的软件将获得以下核心能力：

• 独立回路控制：无视物理开关状态，远程锁死或解锁包间内的照明、麻将机、门禁和空调。

• 门禁自动化：用户支付成功后自动开启电锁（第3路），订单结束后自动断电上锁。

• 环境交互（TTS版） ：基于语音播报能力，实现迎宾提示或超时提醒。

2. 硬件接口定义与场景映射

在开始编码前，需明确硬件的4路物理接口对应的业务逻辑。该控制器尺寸仅 72x90mm，便于嵌入原有配电箱。

注意：第3路接门禁时需注意逻辑，通常是 通电上锁，断电开门。对接代码中控制 power3 时需根据锁类型配置。

3. 对接步骤与核心代码逻辑

芯步开放平台采用 RESTful API 设计，设备通过Wi-Fi 2.4G直连云端，无需网关。开发者仅需关注“签名生成”与“指令下发”两个环节。

3.1 环境准备

1. 注册与创建：在芯步官网注册账号，进入“工作台”并创建“物联网控制台”模块。

2. 获取凭证：在“开发设置”中获取 AppID 和 AppSecret。

3. 设备配网：将控制器连接至本地Wi-Fi。该设备支持5组Wi-Fi备份，信号可自动切换。

3.2 签名机制（Sign）

为了防止接口被恶意篡改，所有请求均需携带动态签名。算法规则为：Sign = md5( md5(AppSecret) + ts )

• ts：当前Unix时间戳（秒）。

3.3 实战：订单开始时的设备初始化

假设用户通过小程序下单成功，系统需要自动开启灯光、插座，并释放门禁数秒。后端调用逻辑如下（以伪代码/Bash示例展示核心请求）：

3.4 核心API命令表

集成过程中，需熟练使用以下order参数结构

单路独立控制

• 功能描述：开关第1路照明

• JSON命令{"power1":1} (开) / {"power1":0} (关)

批量全控

• 功能描述：订单结束，切断所有设备

• JSON命令{"batch":{"power":0}}

空调保护模式（先断后通）

• 功能描述：关闭空调（第4路），并保护压缩机

• JSON命令{"reset":{"relay":[4],"interval":300000}} (先断开，5分钟后才允许再次通电)

语音播报 (仅TTS版本支持)

• 功能描述：提醒用户时间快到了

• JSON命令{"play:gbk:16":"尊敬的用户，您的订单剩余15分钟"}

4. 高级集成与架构

为确保生产环境的稳定性，在软件架构层面进行以下优化：

4.1 设备状态同步

• 主动查询：使用 GET 请求查询设备状态接口，同步本地数据库与硬件实际状态，解决因网络波动导致的状态不一致问题。

• 心跳机制：控制器会定时上报心跳。若连续3个周期未收到心跳，软件系统应自动标记该包间为“设备离线”，并禁止用户下单。

4.2 私有化部署（局域网直连）

若要求高数据安全或网络环境复杂，该控制器支持纯局域网环境运行。

• 方案：在本地服务器部署芯步的私有化服务端，APP通过局域网IP直接调用接口，不经过公网。

• 优势：控制指令延迟极低（毫秒级），不依赖外网宽带。

4.3 自动化联动策略（防冲突设计）

• 门磁防夹：下发开门指令（power3断电）前，软件逻辑中增加判断：若门磁传感器显示“已打开”，则不执行重复指令。

• 空调保护：在夏季高温场景，不直接粗暴断电。可通过API下发空调温度设定（如调至26度）而非直接关闭 power4，以提升用户体验。

5. 总结

通过集成芯步4路远程包间管理控制器MINI，您的软件系统将具备底层的物理感知与控制能力。对接过程技术门槛低（标准HTTP协议），重点在于理解四路负载的业务映射（特别是门禁的逻辑方向）以及合理的超时自动化策略。

开发者在集成测试阶段，利用平台提供的“物联网控制台”手动发送命令{"power1":1}等，验证网络连通性与硬件接线无误后，再进入业务代码编写阶段。