智能4路包间控制器MINI：如何把带语音播报迷你包间控制器接入到项目中_解决方案

CATALOG

芯步的智能4路包间控制器MINI提供标准HTTP API接口，可通过签名认证方式接入任何支持HTTP请求的软件项目。以下方案涵盖硬件选型、接口对接流程、核心代码示例及典型场景应用。

解决方案：智能4路包间控制器MINI接入项目指南

1. 概述与硬件选型

芯步的智能4路包间控制器MINI是一款专为服务型门店（如共享棋牌室、茶室、琴房等）设计的嵌入式和独立式设备。它支持通过标准的 HTTP API接口进行远程控制，能够无缝集成到现有的Web、App、小程序或SaaS平台中。

在接入前，需根据项目需求确认硬件版本：

标准版 (UNI-KZQ-BJ-MINI)：适用于仅需远程控制灯光、麻将机、门禁等基础电器开关的场景。
TTS语音版 (UNI-KZQ-BJ-MINI-TTS)：除开关控制外，自带语音播报功能。适用于需要订单提醒、服务播报或迎宾提示的场景，例如用户下单后自动播报“欢迎光临，XX号包间已准备就绪”。

该设备提供4路独立输出，具体接线规划如下：

线路端口	负载类型	典型接入设备	控制指令参数
第1路	16A开关	照明、换气扇、吸烟灯	`power1`
第2路	16A插座	麻将机、饮水机、按摩仪	`power2`
第3路	10A门禁	电磁锁、电插锁	`power3`
第4路	30A插座	2匹空调	`power4`

2. 核心技术架构与通信流程

该方案的核心理念是“业务系统直连硬件”。设备通过WiFi 2.4GHz直接连接路由器，无需购买额外的网关硬件。项目后端通过调用芯步的开放API，向设备下发指令。

通信流程如下：

设备配网：设备上电后，通过配网模式将其连接到现场WiFi。
获取凭证：开发者登录芯步控制台，获取 AppID 和 AppSecret，并记录设备唯一ID（Device ID）。
签名计算：后端服务器按规则生成签名（Sign）和时间戳（ts）。
指令下发：后端通过HTTP POST请求将JSON格式的命令发送至云端API。
设备执行：云端将指令推送给指定设备，设备执行通断或语音播报。
异步反馈：设备执行结果可通过消息推送机制异步返回给业务服务器。

3. 关键接入步骤与接口详解

3.1 认证与签名计算

为防止接口被恶意调用，所有API请求需携带签名。签名算法规则如下：Sign = md5( md5(AppSecret) + ts )

参数说明：

AppSecret：开发者密钥。
ts：当前Unix时间戳（秒）。
操作顺序：先将 AppSecret 进行MD5加密得到字符串A，再将字符串A与时间戳拼接，最后对拼接后的字符串再次进行MD5加密。

3.2 核心接口：向设备下发指令

这是接入过程中最核心的接口，用于控制继电器通断和语音播报。

请求地址： http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
请求方式： POST
Header： Content-Type: application/json

第一种场景：控制单路设备开关假设需要关闭包间内的麻将机（第2路），命令如下：

注：1代表开启，0代表关闭。

第二种场景：TTS语音播报若使用的是TTS版本，可通过下发文本实现远程语音提醒。这在共享棋牌室或服务门店中非常实用，例如用户在小程序点击“呼叫服务”时触发。

注：[message_3]为内置提示音，支持在播报前加入提示音效。文本支持中文、数字及简单符号。

第三种场景：批量控制与场景联动当客人下机需要清场时，可以一键关闭所有设备，无需逐一发送指令。

4. 代码实战

Python 示例

Java 示例

import okhttp3.*;
import java.io.IOException;

public class ControlDevice {
    public static void main(String[] args) throws Exception {
        String appId = "your_app_id";
        String secret = "your_app_secret";
        String deviceId = "your_device_id";
        long ts = System.currentTimeMillis() / 1000;
        
        // 计算签名
        String md5Secret = md5(secret);
        String signRaw = md5Secret + ts;
        String sign = md5(signRaw);
        
        OkHttpClient client = new OkHttpClient();
        String url = "https://api.thingboot.com/" + appId + "/device/control/?sign=" + sign + "&ts=" + ts;
        
        JSONObject json = new JSONObject();
        json.put("device", deviceId);
        json.put("order", new JSONObject().put("power2", 0)); // 关闭麻将机
        
        RequestBody body = RequestBody.create(MediaType.parse("application/json"), json.toString());
        Request request = new Request.Builder().url(url).post(body).build();
        
        client.newCall(request).enqueue(callbacks);
    }
}

5. 典型应用场景

共享棋牌室/茶室自动化
- 流程：用户在小程序下单 -> 系统调用API开启第4路（空调）和第1路（照明） -> 调用第3路（门禁）断电，门自动关闭（或通电开门）。
- 优势：用户自助体验，无需人工守夜，降本增效。
服务呼叫与语音交互
- 流程：顾客按下包间物理求助按钮（需配合传感器）或扫描二维码 -> 系统后台接收到信号 -> 调用TTS播报：“服务员，请到3号包间服务”。
- 优势：相比传统无线呼叫器，这种方案通过WiFi传输，距离不受限且状态可云端追踪。
能耗管理与定时
- 流程：结合平台的定时任务功能，凌晨2点自动检测并发送 {"power2":0} 关闭麻将机电源，避免待机耗电。

6. 私有化部署

对于数据安全性要求比较高的项目（如政府机构、大型连锁总控），芯步该系列设备支持私有化部署。设备可以直接将数据发送到客户指定的局域网服务器IP，不经过公网云平台，实现纯内网环境运行，保障数据不外流。

通过以上步骤，开发者可以快速在3天内完成从硬件安装到软件全流程的对接，实现软硬一体的智能化升级。