怎么在共享茶室电路管理中接入智能设备以实现远程参数配置管理_解决方案

CATALOG

一、概述

共享茶室作为自助服务型门店的代表业态，其电路管理直接关系到用户体验和运营成本。传统方案中，管理员需要亲临现场处理包间断电、设备复位等问题，效率低下。芯步智能包间控制器通过开放HTTP接口，可无缝接入您的共享茶室管理系统，实现多路电源远程分控、订单联动启停、远程参数配置等自动化管理功能。

核心能力

7路独立分控：单台设备可管理包间内所有电器（照明、空调、麻将机、排风扇、门禁等）
开放HTTP API：适用于任何支持HTTP请求的编程语言，10分钟完成对接
远程参数配置：支持远程调节空调温度、喇叭音量、TTS语速/音色等参数
私有化部署：支持局域网运行，数据不外传
无网关设计：WiFi直连，可设定5组WiFi自动切换

共享茶室包间设备分配方案

回路编号	接口类型	控制对象	典型功率	管理策略
回路1	10A开关	主照明	50-100W	订单开始自动开，结束自动关
回路2	10A开关	排风扇/换气扇	30-50W	订单开始自动开
回路3	10A开关	吸烟灯/氛围灯	50W	客户扫码后点亮
回路4	10A插座	饮水机	500W	订单结束后延时断电
回路5	10A插座	茶具/烧水壶	1000W	按需启用
回路6	10A插座	按摩椅/其他	200W	付费启用
回路7	10A门禁	电磁锁/电插锁	12V DC	一键开门/自动上锁

数据来源：

二、核心产品选型

2.1 智能包间控制器

芯步智能包间控制器专为共享茶室、棋牌室等场景设计，提供多种版本以满足不同包间规模需求

特性	智能包间控制器	智能包间控制器\|Max	智能包间控制器\|Mini
控制路数	7路	8路	4路
空调专用接口	30A插座×1	30A插座×1	30A插座×1
10A开关/插座	3路开关+3路插座	3路开关+3路插座+门禁	2路插座+门禁
总额定功率	6600W	9800W	6600W
语音播报可选	支持TTS版	支持TTS版	支持TTS版
产品尺寸	-	144.6×90×62.8mm	72×90×62.8mm

数据来源：

2.2 产品核心优势

覆盖包间所有电器：提供照明、插座、门禁、空调专用接口等多路输出
开放HTTP接口：适用于任何支持HTTP请求的编程语言，支持Web、APP/小程序、SaaS等平台接入
远程定时任务：支持在平台设置定时任务，实现自动化管理
TTS语音播报（选配）：订单提醒、服务说明、自助引导等可实时合成语音
私有化部署：支持自建消息服务器，可运行在纯局域网环境
无需网关：设备使用WiFi 2.4G无线网络，可设定5组WiFi自动切换

三、整体架构

3.1 系统架构图

┌─────────────────────────────────────────────────────────────────┐
│                    共享茶室管理系统 / 小程序后台                   │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  订单处理   │  │  设备控制   │  │  参数配置   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ HTTP API调用（携带签名）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ WiFi 2.4GHz
          ┌───────────────────┼───────────────────┐
          │                   │                   │
          ▼                   ▼                   ▼
    ┌──────────┐       ┌──────────┐       ┌──────────┐
    │ 包间A    │       │ 包间B    │       │ 包间C    │
    │ 控制器   │       │ 控制器   │       │ 控制器   │
    │ ┌──────┐ │       │ ┌──────┐ │       │ ┌──────┐ │
    │ │照明  │ │       │ │照明  │ │       │ │照明  │ │
    │ │空调  │ │       │ │空调  │ │       │ │空调  │ │
    │ │门禁  │ │       │ │门禁  │ │       │ │门禁  │ │
    │ │茶具  │ │       │ │茶具  │ │       │ │茶具  │ │
    │ └──────┘ │       │ └──────┘ │       │ └──────┘ │
    └──────────┘       └──────────┘       └──────────┘

四、API接口接入详解

4.1 接口地址与签名计算

请求地址

https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

参数说明

参数	说明	示例
{AppId}	应用ID，控制台获取	`qtyVWcgeMq`
{ts}	当前Unix时间戳（秒）	`1747212640`
{sign}	签名	`c484eb97...`

签名计算公式

sign = md5( md5(AppSecret) + ts )

将开发者密码（AppSecret）进行一次MD5
将这个结果拼接上时间戳ts
对整个拼接后的字符串再做一次MD5

签名计算示例

4.2 核心命令详解

4.2.1 电源独立控制

数据来源：

4.2.2 批量控制（订单联动场景）

批量控制可同时控制任意组合的回路，适用于订单开始/结束时的全包间设备管理：

数据来源：

4.2.3 空调温度控制（远程参数配置）

共享茶室可远程设置空调温度，实现预冷/预热管理：

说明：此为示例，具体命令请参见官方文档

4.2.4 语音播报与参数配置（TTS版本）

TTS版本支持远程语音播报，可用于订单提醒、服务说明等场景

命令说明：

语音参数配置项

参数	命令	取值范围	说明
音量	`{"volume":"X"}`	0-9	0静音，9最大
音色	`{"voice":"X"}`	0/1	0女声，1男声
语速	`{"speed":"X"}`	0-9	0最慢，9最快
语调	`{"tone":"X"}`	0-9	调节语调
提示音	`{"play:gbk:16":"[message_X]"}`	1-5	5种内置提示音
警示音	`{"play:gbk:16":"[alert_X]"}`	1-5	5种内置警示音
停止	`{"stop":"1"}`	-	停止所有播报

4.2.5 门禁控制（先通后断）

电磁锁/电插锁通常需要短时通电开锁

先接通回路7（门禁），3秒后自动断开

4.2.6 远程复位（先断后通）

适用于设备异常时的远程复位

先断开回路4，5秒后自动接通

4.3 多语言代码示例

Python（完整茶室管理类）

import requests
import time
import hashlib
from typing import List, Dict, Optional

class TeaRoomController:
    """共享茶室包间控制器"""
    
    # 回路编号映射
    RELAY_MAP = {
        "light": 1,      # 照明
        "fan": 2,        # 排风扇
        "ambient": 3,    # 氛围灯
        "water": 4,      # 饮水机
        "teaset": 5,     # 茶具电源
        "massage": 6,    # 按摩椅
        "door": 7        # 门禁电磁锁
    }
    
    def __init__(self, app_id: str, app_secret: str, device_id: str):
        self.app_id = app_id
        self.app_secret = app_secret
        self.device_id = device_id
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def _generate_sign(self, ts: int) -> str:
        """生成签名"""
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def _send_command(self, order: dict) -> dict:
        """发送命令到设备"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {"device": self.device_id, "order": order}
        
        response = requests.post(url, json=payload, timeout=5)
        return response.json()
    
    # ========== 电源控制 ==========
    def control_relay(self, relay_name: str, on: bool, extra: str = None) -> dict:
        """控制单个设备"""
        relay = self.RELAY_MAP.get(relay_name)
        if not relay:
            return {"error": f"未找到设备: {relay_name}"}
        
        order = {f"power{relay}": "1" if on else "0"}
        if extra:
            order["extra"] = extra
        return self._send_command(order)
    
    def batch_control(self, relays: List[int], on: bool) -> dict:
        """批量控制多个回路"""
        order = {
            "batch": {
                "relay": relays,
                "power": "1" if on else "0"
            }
        }
        return self._send_command(order)
    
    def all_on(self) -> dict:
        """包间全开（订单开始）"""
        relays = list(range(1, 8))
        return self.batch_control(relays, True)
    
    def all_off(self) -> dict:
        """包间全关（订单结束）"""
        relays = list(range(1, 8))
        return self.batch_control(relays, False)
    
    # ========== 订单联动（核心功能）==========
    def start_booking(self, duration_minutes: int = 120) -> dict:
        """订单开始:开启包间所有设备"""
        result = self.all_on()
        
        # 可选:开启空调并设置温度
        # self.set_aircon_temperature(24)
        
        # 可选:播报欢迎语音
        # self.voice_broadcast("[message_3]欢迎光临，包间已开启")
        
        # 可选:设置订单结束定时关电
        self.schedule_auto_off(duration_minutes)
        
        return result
    
    def end_booking(self) -> dict:
        """订单结束:关闭包间所有设备"""
        result = self.all_off()
        
        # 可选:播报结束提示
        # self.voice_broadcast("订单时间已到，感谢您的使用")
        
        return result
    
    # ========== 门禁控制 ==========
    def unlock_door(self, duration_ms: int = 5000) -> dict:
        """一键开门（先通后断）"""
        order = {
            "point": {
                "relay": [self.RELAY_MAP["door"]],
                "interval": duration_ms
            }
        }
        return self._send_command(order)
    
    # ========== TTS语音播报（选配）==========
    def voice_broadcast(self, text: str, volume: int = 7, voice: int = 1) -> dict:
        """语音播报"""
        order = {
            "play:gbk:16": text,
            "volume": str(volume),
            "voice": str(voice)
        }
        return self._send_command(order)
    
    def welcome_broadcast(self, room_name: str) -> dict:
        """欢迎语播报"""
        text = f"[message_3]欢迎光临{room_name}，包间已为您开启，空调预设26度，祝您品茶愉快"
        return self.voice_broadcast(text, volume=7)
    
    def timeout_warning(self, minutes_left: int) -> dict:
        """订单即将结束提醒"""
        text = f"[message_2]您的订单还剩{minutes_left}分钟，如需续费请扫码操作"
        return self.voice_broadcast(text, volume=7)
    
    # ========== 参数配置 ==========
    def configure_voice(self, volume: int = None, voice: int = None, 
                        speed: int = None, tone: int = None) -> dict:
        """配置语音参数"""
        order = {}
        if volume is not None:
            order["volume"] = str(volume)
        if voice is not None:
            order["voice"] = str(voice)
        if speed is not None:
            order["speed"] = str(speed)
        if tone is not None:
            order["tone"] = str(tone)
        return self._send_command(order)
    
    # ========== 定时任务 ==========
    def schedule_auto_off(self, minutes: int):
        """订单结束后自动关电（需配合业务系统定时任务）"""
        # 此方法为业务系统侧实现
        pass

# 使用示例
controller = TeaRoomController("your_app_id", "your_app_secret", "tearoom_01")

# 客户扫码下单，包间自动通电
controller.start_booking(duration_minutes=120)

# 一键开门
controller.unlock_door()

# 订单结束，自动断电
controller.end_booking()

# 语音播报提醒
controller.welcome_broadcast("国色天香")

五、共享茶室场景实战

5.1 第一种场景：扫码下单自动通电

需求：用户扫码支付成功后，包间自动通电（照明、空调、茶具插座等），门锁自动打开。

实现的方式是：小程序支付回调触发HTTP API

5.2 第二种场景：订单即将结束语音提醒

需求：订单结束前5分钟，自动通过TTS播报提醒用户续费。

实现的方式是：业务系统定时任务触发

5.3 第三种场景：空调远程预冷/预热

需求：用户预订包间后，系统自动提前开启空调，调节至舒适温度。

5.4 场景四：现场一键开门/关门

需求：用户到店后，在小程序点击“一键开门”即可进入，无需前台接待。

实现的方式是：小程序调用API实现先通后断

5.5 场景五：远程参数集中管理（运维核心）

需求：管理员在后台远程批量配置所有包间控制器的播报参数（音量、语速、音色等），无需现场操作。

实现的方式是：调用语音参数配置命令

class BatchConfigManager:
    """批量配置管理器"""
    
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def batch_config_voice(self, device_ids: List[str], volume: int, voice: int):
        """批量配置多个包间的语音参数"""
        for device_id in device_ids:
            # 构建请求参数
            ts = int(time.time())
            sign = self._generate_sign(ts)
            url = f"{self.base_url}?sign={sign}&ts={ts}"
            
            payload = {
                "device": device_id,
                "order": {
                    "volume": str(volume),
                    "voice": str(voice)
                }
            }
            
            response = requests.post(url, json=payload)
            log_config_change(device_id, volume, voice, response.json())
        
        return {"status": "ok", "updated": len(device_ids)}

# 使用示例:将所有包间的音量统一调至7，音色设为男声
manager = BatchConfigManager("app_id", "app_secret")
manager.batch_config_voice(all_device_ids, volume=7, voice=1)

5.6 场景六：设备状态远程监控

需求：管理员远程查看各包间设备的在线状态及运行情况。

实现的方式是：主动查询或消息推送

六、私有化部署方案

共享茶室运营方对数据安全和成本控制有较高要求，芯步控制器支持纯局域网运行。

部署模式对比

特性	公有云模式	私有化模式
设备联网	WiFi连接互联网	连接茶室内网WiFi
API地址	`api.thingboot.com`	自建服务器IP
数据流向	经过芯步云端	内网直连，数据不出茶室
网络依赖	需要互联网	仅需局域网
适用场景	快速部署、轻量化	连锁品牌、数据安全要求高

私有化配置要点

设备支持配置5组WiFi网络，自动连接信号最强的网络
需自建HTTP服务，所有API调用在内网完成
支持自建消息服务器，接收设备状态回调

七、设备安装部署指南

7.1 安装要求

项目	要求
安装方式	标准配电箱安装
工作电压	DC 5V 2A（直流）
单路负载	10A插座回路≤2200W，30A空调回路≤6600W
总额定功率	全接通时总负载≤包间对应型号上限
网络要求	WiFi 2.4GHz信号覆盖良好
安装空间	包间配电箱内

7.2 包间回路分配

根据共享茶室包间实际情况，可按以下配置方案分配控制回路

回路编号	推荐用途	接口类型	说明
回路1	主照明	10A开关	订单开始自动开
回路2	排风扇/换气	10A开关	保持空气流通
回路3	氛围灯/装饰灯	10A开关	提升品茶氛围
回路4	饮水机/热水器	10A插座	订单结束后延时断电
回路5	茶具/烧水壶	10A插座	按需启用
回路6	按摩椅/备用	10A插座	扩展用途
回路7	门禁电磁锁	10A门禁	直流12V电磁锁
回路8（如有）	空调	30A插座	2匹空调专用

7.3 版本选择

包间类型	推荐设备	理由
单人小包间	智能包间控制器	7路基本够用
双人/中包间	智能包间控制器\|Max	8路空调专用，功率更大
豪华大包间	智能包间控制器\|Max + TTS	8路+TTS语音播报
成本优先型	智能包间控制器\|Mini	4路紧凑配置

八、配套软件方案

芯步提供完整的共享茶室软件解决方案

用户端（微信小程序）功能

在线预约包间（日期、时段选择）
一键开门/续单/离店
查看WIFI信息
会员储值与卡券使用
抖音团购券核销

管理端（电脑网页）功能

包间设备管理（远程控制）
预约记录统计
保洁任务管理
门店与品牌信息配置
退款比例设置

可选软件方案

配套小程序与后台：800元/年/门店
一次性买断：3600元/门店
完整源代码：12000元/套（供二次开发）

九、常见问题与排障

问题	可能原因	解决方案
设备不在线	WiFi信号被屏蔽	检查2.4GHz WiFi覆盖，设备支持5组WiFi自动切换
空调无法控制	负载超限	确认空调功率是否≤额定值
门锁无法打开	接线错误/锁类型	确认电磁锁为直流12V，接线正确
命令下发成功但设备无响应	设备离线	200仅表示平台接收，需确认设备在线状态
语音播报无声	音量设置过低	调高volume至7或以上，确认TTS版本
签名验证失败	参数错误	确认ts为秒级时间戳，签名公式为`md5(md5(AppSecret)+ts)`

十、总结

本方案基于芯步智能包间控制器，实现了共享茶室的全自动化电路管理

能力	实现的方式是
扫码下单自动通电	支付回调触发API批量控制
一键开门	`point`先通后断命令
语音播报提醒	TTS文本实时合成
远程参数配置	音量/音色/语速API调节
订单结束自动断电	批量控制命令关断所有回路
设备状态监控	主动查询或消息推送
空调远程控制	通过专用30A回路+温度设置
连锁集中管理	多设备批量控制

集成核心步骤

根据包间规模选择控制器型号（标准版/Max/Mini）
获取AppID/AppSecret，实现MD5签名算法
开发订单联动逻辑（支付→通电→开门→定时关电）
可选：配置TTS语音播报模板
物理安装设备，进行上线测试

方案优势

✅ 7-8路独立控制：单设备覆盖茶室所有电器
✅ 接口统一：标准HTTP API，10分钟完成对接
✅ 订单全流程联动：从下单到离店自动化管理
✅ 远程参数配置：无需到场即可调整设备参数
✅ TTS语音播报：订单提醒、服务说明自动化
✅ 私有化支持：数据安全可控，适合连锁品牌

如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。

一、概述

二、核心产品选型

2.1 智能包间控制器

2.2 产品核心优势

三、整体架构

3.1 系统架构图

四、API接口接入详解

4.1 接口地址与签名计算

4.2 核心命令详解

4.2.1 电源独立控制

4.2.2 批量控制（订单联动场景）

4.2.3 空调温度控制（远程参数配置）

4.2.4 语音播报与参数配置（TTS版本）

4.2.5 门禁控制（先通后断）

4.2.6 远程复位（先断后通）

4.3 多语言代码示例

Python（完整茶室管理类）

五、共享茶室场景实战

5.1 第一种场景：扫码下单自动通电

5.2 第二种场景：订单即将结束语音提醒

5.3 第三种场景：空调远程预冷/预热

5.4 场景四：现场一键开门/关门

5.5 场景五：远程参数集中管理（运维核心）

5.6 场景六：设备状态远程监控

六、私有化部署方案

七、设备安装部署指南

7.1 安装要求

7.2 包间回路分配

7.3 版本选择

八、配套软件方案

九、常见问题与排障

十、总结

断路器产品方案：

怎么二次开发50A带计量数显物联网断路器来实现场景联动控制

怎么对接60A带计量物联网断路器以实现过压欠压保护控制

共享充电宝柜电源管理：怎么将40A 智能断路器集成到软件项目中

便利店收银机电源管理：怎么将60A带计量远程智能空开集成到软件项目中

怎样对接60A带计量数显物联网断路器来实现额定功率负载控制

共享茶室场景方案：

如何在共享茶室人走断电与安全检测中对接智能设备以实现火灾烟雾报警

共享茶室照明插座控制：如何把6600W 线路控制器对接到软件项目中

共享茶室前台语音接待场景：如何把40W远程TTS语音播报壁挂器对接到项目中

怎样在共享茶室照明控制中集成智能硬件来实现远程控制8路照明设备通断

共享茶室灯光控制：如何将2路物理按键墙壁开关集成到自己的项目中

管理用途方案：

怎么二次开发单开智能出门开关来实现远程参数配置管理

怎么在4路HTTP接口包间控制器MINI中集成智能硬件以实现包间门禁系统联动管理

怎样在共享场所中对接智能硬件以实现动态密码管理

怎么在舞蹈练习室设备管理中接入智能设备以实现包间设备分组独立管理

如何在商场展柜电源控制中接入智能设备来实现远程参数配置管理