琴房智能化的关键在于：用户扫码即可自助使用，时间结束后自动断电。以下方案围绕芯步智能包间控制器Mini的HTTP接口，说明如何将其快速接入现有软件系统。

1. 背景与需求分析

在传统的琴房管理模式下，通常面临人工管理成本高、时段利用率不透明、学员预约后钥匙/卡交接麻烦等问题。通过引入芯步智能包间控制器Mini，可以将琴房的灯光、空调、门禁以及电源总闸进行全面的物联网化改造。

本方案的目标是指导开发者如何利用芯步提供的开放 HTTP API，在现有的公众号、小程序或 PC 端管理软件中，实现对琴房设备的远程控制、状态监控和自动化的商业闭环（如：付费即用、到点断电）。

2. 硬件选型：智能包间控制器Mini

针对琴房场景，推荐使用 “智能包间控制器Mini（TTS语音版）”。

硬件规格与接线规划：

• 第1路（16A）：接入 照明与换气扇。学员进入时自动亮灯，离开或超时后自动关闭。

• 第2路（16A）：接入 饮水机或辅助插座。非使用时段关闭以避免待机能耗。

• 第3路（10A）：接入 门禁电磁锁。实现线上支付成功后自动开门，形成“先付费后使用”的闭环。

• 第4路（30A）：专门接入 2匹以下空调。允许学员远程提前开空调，或根据室内温湿度传感器联动调节。

设备特性：

• 通讯方式：直连 2.4G WiFi，无需额外购买网关，降低部署成本。

• 接口协议：支持标准 HTTP 请求，兼容局域网及公网环境，支持私有化部署。

3. 接口对接技术方案

芯步的接口设计遵循无状态、轻量化的原则，适用于任何支持 HTTP 请求的编程语言（Java, Python, PHP, Node.js 等）。

3.1 鉴权与签名机制

为了防止接口被恶意调用，所有请求都需要进行签名校验。核心逻辑为：sign = md5( md5(AppSecret) + ts )

参数说明：

• AppId / AppSecret：在芯步物联网控制台创建“工作台”后获取。

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

极简鉴权流程

1. 将开发者密码（AppSecret）进行一次 MD5 加密。

2. 将上述结果拼接上当前的时间戳（ts）。

3. 对拼接后的字符串再次进行 MD5 加密，得到最终的 sign。

3.2 核心接口集成：琴房上下电

当用户在前端（如小程序）点击“开始使用”或“结束使用”时，后端需调用设备控制接口。

请求地址： http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

请求方式： POST

控制琴房全部开启（开锁、开灯、开空调）

控制琴房全部关闭（强制断电，清理卫生）

3.3 丰富场景：TTS语音播报

利用该硬件的 TTS 功能，可以极大提升用户体验。

场景应用

1. 到点提醒：在课程结束前 5 分钟，推送语音提醒用户续费或准备离开现场时。

2. 欢迎语：用户扫码开锁成功后，设备播报“欢迎 XXX，琴房已解锁，祝您练习愉快”。

接口指令

4. 软件项目集成步骤

4.1 设备配网与绑定

在实际编程前，首先需要完成物理硬件的联网。

1. 登录芯步控制台，录入现场琴房的 2.4G WiFi 名称和密码。

2. 通过手机热点模式（SmartConfig）或 AP 模式，将控制器配置上网。

3. 在系统中记录下每个琴房对应的 Device ID，并绑定到业务数据库的“教室/琴房”字段中。

4.2 业务逻辑流程图

在软件项目中，采用以下的业务逻辑闭环：

1. 用户端操作：用户在小程序下单支付。

2. 服务端处理：支付回调触发 -> 调用 power3=1 开门 -> 间隔 2 秒 -> 调用户电源总开关。

3. 心跳检测：用户开始使用后，前端应定时请求后端，后端透传查询设备状态（可选，或依赖被动上报），确保界面显示与实际一致。

4. 自动结算：订单倒计时结束 -> 调用 power1=0, power4=0 关闭娱乐设备 -> 等待 10 秒 -> 调用 power3=0 锁门 -> 标记订单完结。

4.3 私有化与局域网部署（高可用）

对于网络环境极佳且注重隐私的琴行，芯步支持私有化部署。

• 配置方式：在设备配网时，将 服务器地址 修改为自建的服务器 IP 或域名。

• 优势：指令传输不经过芯步公共云，直接在内网传输，延迟可降至 10ms 以内，且断外网时依然可以本地控制。

5. 扩展与联动方案

单纯的开关控制已足够，但结合芯步的传感器生态，可以将琴房升级为“无人值守智能空间”：

1. 人体存在传感器联动在琴房内安装“智能人体存在传感器”。如果检测到订单进行中但长达 15 分钟无人活动，系统可自动推送消息提醒管理员，或自动结束订单释放资源，避免资源浪费。

2. 环境监测联动琴房通常较为密闭，若安装烟感传感器，一旦检测到烟雾浓度超标，服务器可直接调用控制器接口强制切断所有电源，并将警报推送给管理人员，确保消防安全。

6. 总结

将芯步智能包间控制器Mini接入软件项目，主要通过以下三个技术动作完成：

1. 获取凭证：在控制台获取 AppID/Secret 和设备 ID。

2. 计算签名：遵循 md5(md5(secret)+ts) 规则构建请求头。

3. 下发指令：通过 POST 请求向 /device/control/ 接口发送 JSON 数据包，控制 power1 至 power4 的开关状态。

该方案不需要复杂的嵌入式开发，仅需普通的 Web 开发能力即可实现琴房的 自动化、远程化、无人化管理，显著降低运营成本并提升效率。