共享茶室的电源管理痛点在于：不同时段的用户需要独立控制自己所在包间的设备（灯、麻将机、烧水壶等），但又不能互相干扰，同时经营者需要远程统管。以下方案基于芯步开放接口，采用双路智能控制器实现单路/双路的灵活控制。
1. 背景与需求分析
在共享茶室/棋牌室场景中，常常需要对同一包间内的不同设备进行精细化电源管理。典型场景是：照明需要常开或按需开关，而麻将机/茶炉等设备则随订单自动通电。
传统的机械开关或单路智能插座无法满足“单路独立控制”与“双路联动控制”并存的需求。本方案基于 芯步生态的智能硬件与开放API，旨在解决以下痛点：
独立控制：用户扫码开灯，仅获取照明权限；或开启包厢后，照明与插座同时通电。
时序联动：订单即将结束时，语音播报提醒，照明闪烁，但不切断核心设备电源，以防数据丢失。
远程运维：后台可远程重启某一路设备（如解决麻将机死锁问题），无需人员到场。
2. 硬件选型
为实现单路/双路独立通断，我们不能使用简单的两插位排插（其内部多为并联，同开同关），需采用具有双路独立继电器且支持API控制的设备。
根据芯步产品线及生态兼容性，推荐选用 智能包间控制器 系列：
| 设备类型 | 推荐型号 | 核心作用 | 选择理由 |
|---|---|---|---|
| 核心控制器 | UNI-KZQ-BJ-MINI (双路/多路版) | 电源通断执行与语音播报 | 支持HTTP控制，双路物理隔离，每路负载最高支持3500W |
| 感知设备(可选) | 智能人体存在传感器 | 节能与安全监测 | 判断包间是否有人，无人自动断电 |
| 通讯基础 | WiFi 2.4G / 局域网 | 网络连接 | 设备直连云端或局域网，无需网关 |
注：若仅需简单的插座级控制，亦可选用芯步生态内的智能通断器，但为了“茶室”场景的专业性和负载稳定性，使用包间控制器。
3. 接口对接架构
芯步采用标准的 HTTP/HTTPS 协议 进行控制，架构如下：
flowchart LR
SubGraph1[用户端/小程序] -->|扫码/支付| Backend[共享茶室SaaS后台]
Backend -->|HTTP API调用
签名认证| YoYoAPI[芯步开放API]
YoYoAPI -->|MQTT/长连接| Device[包间内智能控制器
UNI-KZQ-BJ-MINI]
Device -->|第1路继电器| Light[照明设备]
Device -->|第2路继电器| Socket[茶炉/麻将机插座]
Sensor[人体传感器] -->|状态上报| YoYoAPI
YoYoAPI -->|Webhook| Backend4. 业务逻辑与API实现
4.1 接口基础配置
芯步开放平台要求所有请求携带签名以确保安全 。
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/鉴权方式：URL携带
sign（签名）和ts（时间戳）。数据格式：JSON
4.2 单路独立控制逻辑
共享茶室最常见的需求是：用户购买“灯光套餐”或“全时段套餐”。
场景A：用户只想休息一会，只开灯不开空调/茶炉。
接口指令
注：参考芯步传感器控制命令格式，控制器通常扩展为 power1, power2 或类似参数 。
4.3 双路联动（组合）控制逻辑
场景：用户下单成功后，系统需要同时打开照明和插座。策略： 虽然可以连续调用两次单路接口，但为了降低延迟和事务风险，后台封装组合指令，或发送全量状态指令。
4.4 异常处理与超时保护
在共享茶室中，用户可能提前离开。可利用 人体存在传感器 实现自动化节能 。
数据上报：传感器检测到“无人”状态持续10分钟，向服务器推送
{"radar":"无人"}。后台联动：服务器收到此消息后，调用控制接口关闭第1路（照明）和第2路（设备），并标记订单结束。
5. 安全与部署方案
5.1 私有化部署（局域网方案）
对于注重隐私或网络稳定性要求比较高的茶室，芯步支持私有化部署 。控制器直接与本地服务器通信，不经过外网。
优势：极低延迟（<50ms），断网仍可控制。
适用：大型连锁茶楼。
5.2 负载安全设计
硬件层：所选控制器单路支持最大16A电流，足以应对电磁茶炉和麻将机的感性负载启动电流冲击 。
逻辑层：在API调用中增加命令缓存与去重机制，防止网络抖动导致继电器频繁吸合损坏。
6. 实施流程
| 步骤 | 操作内容 | 关键点 |
|---|---|---|
| 1. 设备配网 | 使用芯步配网工具，将控制器连接至茶室WiFi | 确保2.4G频段开启 |
| 2. 获取设备ID | 在芯步控制台或通过API查询设备唯一ID | 如 device":820720 |
| 3. 接口开发 | 在SaaS系统中集成签名算法与设备控制逻辑 | 实现单路/双路独立调用 |
| 4. 线路接线 | 火线接入控制器输入端；第一路出线接照明；第二路出线接通用插座 | 严格区分零火线，避免短路 |
| 5. 逻辑测试 | 测试“仅开灯”、“仅开插座”、“全开”、“超时全关”场景 | 验证反馈状态的准确性 |
7. 总结
通过在共享茶室部署基于芯步开放接口的多路智能控制器，开发者可轻松利用 HTTP API 调用 实现对 /control 接口的参数化配置，完成两路电源从“粗放式管理”到“精细化独立控制”的升级。该方案不仅解决了用户分时租赁的灵活计费问题，结合传感器与私有化部署能力，还大幅降低了茶室的运营能耗与运维成本。