4路智能包间控制器MINI：怎样将4路包间电源智能控制器MINI接入到软件项目中_解决方案

CATALOG

芯步智能包间控制器Mini采用HTTP接口开放策略，单路可承载最高6600W负载，支持任何能发起HTTP请求的编程语言接入。以下方案涵盖接口鉴权、设备控制、事件监听及项目集成四个核心环节。

解决方案：将4路包间电源智能控制器MINI接入软件项目

1. 概述

4路智能包间控制器Mini（型号：UNI-KZQ-BJ-MINI） 是一款专为共享棋牌室、茶室、自习室等空间设计的物联网硬件。它支持通过WiFi 2.4G网络联网，提供4路继电器输出，单路最大负载可达6600W（空调/麻将机），并且TTS版本还支持语音播报功能。

要将该设备接入您的软件项目（Web/APP/小程序），核心是利用其提供的开放HTTP接口。该接口无需网关，直连路由器，支持公网或纯局域网环境下的私有化部署。

2. 接入流程与技术准备

2.1 硬件与网络准备

设备上电：为控制器通上5V1A直流电。
网络配置：设备通常通过声波配网或SmartConfig方式配置WiFi。注意：仅支持2.4G WiFi，不支持5G。
获取设备ID：设备联网后，会在芯步管理后台生成唯一的Device ID（如：1878），这是后续API操作的核心凭证。

2.2 接口鉴权机制

所有API请求均需要携带签名（Sign），采用双重MD5加密机制，有效防止接口被篡改。

核心参数AppID， AppSecret， ts（时间戳）， Device ID。
签名算法YourSign = md5( md5(AppSecret) + ts )即：将AppSecret进行一次MD5加密，得到的结果后面拼接上当前时间戳（秒级），再对整个字符串进行一次MD5加密。

3. 核心功能开发实战

3.1 API请求基础地址

POST https://api.thingboot.com/{AppID}/device/control/？sign={YourSign}&ts={ts}
Content-Type: application/json

3.2 控制单路或多路继电器

这是最核心的功能，用于控制灯、麻将机、空调的开关。

示例：关闭包间的空调（第4路）空调通常接在第4路（30A继电器）。

请求参数
{ "device": "1878"， // 设备ID "order": {"power4": 0} // 0为断开，1为闭合 }

示例：一键全开/全关在用户下单或时间结束时，需要批量控制。

全关指令： {“batch”：{“power”： 0}}
指令参考
- 第1路（照明）：{“power1”： 1}
- 第2路（插座/麻将机）：{“power2”： 1}
- 第3路（门锁）：{“power3”： 1}
- 第4路（空调）：{“power4”： 1}

3.3 场景联动与高级指令

Mini控制器支持逻辑控制，非常适合包间预订的打扫或清场逻辑。

先断后通（Reset）：常用于门禁控制或设备重启。
- 场景：用户点击“开锁”，第3路通电5秒后自动断电，防止电磁锁线圈烧坏。
- 指令： {“reset”： {“relay”： [3], “interval”： 5000}} （第3路通电5秒后断开）。
先通后断（Point）：常用于测试模式或临时照明。
语音播报（仅TTS版）：当用户订单即将超时时，控制设备语音提醒。
- 指令： {“play：gbk：16”：“您好，欢迎光临”}。

3.4 接收设备状态（消息推送）

为了同步电器的真实状态（如被人手动按了强制关闭开关），您的服务器需要接收设备上报的状态。

配置回调：在开发者控制台设置消息推送URL。
推送数据：当设备状态变化时（如温度异常、继电器通断），平台会向您的服务器发送JSON数据。
处理逻辑：您需要开发一个接收接口来解析这些数据，更新数据库中的“设备状态”字段。

4. 代码集成示例（后端Node.js示例）

假设您正在开发一个棋牌室订单系统，用户支付成功后自动通电。

const crypto = require(‘crypto’）；
const axios = require(‘axios’）；

// 配置常量
const APP_ID = ‘your_app_id’；
const APP_SECRET = ‘your_app_secret’；
const DEVICE_ID = ‘1878’； // 实际设备ID

// 生成签名
function generateSign（） {
    const ts = Math.floor（Date.now（） / 1000）； // 秒级时间戳
    const md5Secret = crypto.createHash（‘md5’）.update（APP_SECRET）.digest（‘hex’）；
    const signStr = md5Secret + ts；
    const sign = crypto.createHash（‘md5’）.update（signStr）.digest（‘hex’）；
    return { ts, sign }；
}

// 控制设备:开启所有包间设施
async function openRoom（） {
    const { ts, sign } = generateSign（）；
    const url = `https://api.thingboot.com/${APP_ID}/device/control/？sign=${sign}&ts=${ts}`；
    
    try {
        const response = await axios.post（url, {
            device: DEVICE_ID,
            // 场景:开灯（1路）， 开麻将机（2路）， 开空调（4路）
            order: { "power1": 1, "power2": 1, "power4": 1 }
        }）；
        
        if （response.data.code === 0） {
            console.log（"设备控制成功"）；
            // 更新数据库订单状态为"使用中"
        }
    } catch （error） {
        console.error（"控制失败"， error）；
    }
}

// 场景:订单结束，打扫房间（先关空调，等待10秒后关灯，断电）
async function cleanRoom（） {
    // 逻辑:先关空调（4路），延迟10秒后关灯（1路）
    // 由于HTTP命令是无状态的，后端使用setTimeout或消息队列实现延迟
    // 或者直接发送全关指令:{"batch":{"power": 0}}
}

5. 最佳实践和需要注意的点

私有化部署方案：如果您的项目对数据安全要求比较高（如内网环境），可将API请求地址从公网域名（api.thingboot.com）切换为设备的局域网IP地址。设备支持UDP广播发现和局域网直连控制，无需外网中断。
负载功率阈值
- 第1/2路：最大3500W（阻性负载），适用于照明、麻将机。
- 第3路：门禁专用，负载较小（2200W），若接大功率电器可能导致损坏。
- 第4路：最大6600W，专为2匹以上空调设计。
超时与重试：HTTP请求通常响应在80-120ms之间。在公网环境下，需设置合理的超时时间（3s），并设计重试机制（最多3次）以应对网络波动。
心跳维护：虽然设备会自己重连，但您的软件定期（如每5分钟）查询一次设备在线状态，以便在前端显示“设备离线”提示，避免用户下单后无法开门。

通过上述步骤，您可以快速地将4路包间控制器集成到现有的软件后台中，实现远程控制、自动计费和智能联动。