4路智能包间控制器MINI：怎样把4路包间场景联动控制器MINI对接到自己的项目中_解决方案

CATALOG

4路智能包间控制器MINI的核心价值在于其全开放的HTTP API接口——通过4路独立继电器控制照明、插座、门锁和空调，配合80-120ms的响应延迟和批量/定时控制能力，可无缝集成到棋牌室、茶室等场景的自有系统中。以下是技术对接方案：

1. 产品概述与对接价值

芯步4路智能包间控制器MINI是一款专为服务型门店（共享棋牌室、茶室、休息室、琴房等）设计的物联网硬件设备。该设备的核心价值在于：

4路独立控制：可分别控制照明、插座、门锁、空调等包间内主要电器
全开放API接口：提供标准HTTP接口，支持公网、局域网及私有化部署
快速集成：接口设计简洁，十分钟即可完成基础对接

通过对接，您可以将包间电器的远程控制能力无缝集成到自有系统（小程序、APP、SaaS平台等）中，实现扫码开房、自动断电、远程门禁管理等完整业务闭环。

2. 硬件规格与接口说明

2.1 4路输出定义

根据产品规格，4路输出对应的控制参数如下：

线路编号	接口类型	负载能力	典型用途	控制参数
第1路	16A开关	3500W(阻性)/500W(感性)	照明、换气扇、吸烟灯	`power1`
第2路	16A插座	3500W(阻性)/500W(感性)	饮水机、麻将机、按摩椅	`power2`
第3路	10A门禁接口	2200W(阻性)/350W(感性)	电磁锁、电插锁	`power3`
第4路	30A插座	6600W(阻性)/1100W(感性)	2匹空调	`power4`

2.2 两种版本选择

标准版（UNI-KZQ-BJ-MINI）：基础4路控制功能
TTS版（UNI-KZQ-BJ-MINI-TTS）：额外支持远程语音播报，可用于订单提醒、服务说明等场景

2.3 技术参数

工作电压：DC 5V/1A
无线连接：WiFi 2.4GHz (802.11 b/g/n)
响应时间：80-120ms
支持私有化部署和纯局域网运行

3. API对接技术方案

3.1 接口基础信息

请求地址

http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

请求方式：POST（参数较长时推荐）或 GET

参数说明

{AppID}：应用ID，在芯步控制台创建应用后获取
sign：签名，用于身份验证
ts：Unix时间戳

3.2 签名生成方法

3.3 单路控制示例

场景1：客人下单后自动打开第1路（照明）

场景2：计时结束时关闭所有设备

3.4 批量控制（高效操作）

3.5 门禁控制特殊处理

第3路通常用于门禁电磁锁，推荐使用先断后通（reset）命令实现开门后自动关门：

3.6 定时任务实现

设备支持本地定时任务，无需服务器队列：

3.7 TTS语音播报（仅TTS版本）

4. 业务场景集成方案

4.1 共享棋牌室完整流程

sequenceDiagram
    participant 用户
    participant 小程序 as 用户小程序
    participant 服务器 as 商家服务器
    participant 控制器 as 包间控制器MINI
    
    用户->>小程序: 扫码下单
    小程序->>服务器: 请求开房
    服务器->>控制器: power3=0(门锁断电)
    控制器-->>服务器: 门锁开启
    服务器->>控制器: power1=1(照明开)
    服务器->>控制器: power2=1(麻将机开)
    服务器->>控制器: power4=1(空调开)
    服务器->>小程序: 开房成功
    用户->>小程序: 进入包间
    
    Note over 服务器: 订单计时中...
    
    服务器->>控制器: reset: relay=[4], interval=600000
    Note over 控制器: 空调10分钟后关闭
    
    服务器->>小程序: 剩余时间提醒
    用户->>小程序: 续费
    服务器->>控制器: reset续期
    
    服务器->>小程序: 订单结束
    服务器->>控制器: power1=0,power2=0,power3=1,power4=0
    Note over 控制器: 锁门、断电