共享桌游室灯光空调控制：怎么将20A 智能开关接入到软件项目中_解决方案

CATALOG

[23860] 文档版本：V1.0 更新日期：2026年5月 适用对象：软件工程师、系统集成商、共享空间项目负责人

第一章：场景痛点与解决概述

1.1 共享桌游室的运营管理挑战

共享桌游室作为一种新兴的无人自助业态，近年来发展迅速。然而，在实际运营中，经营者普遍面临以下痛点：

痛点	具体表现	带来的问题
能耗浪费严重	用户离开现场时后忘记关灯、关空调	电费持续产生，单月可浪费数百元
手动管理效率低	每个包间需人工巡查开关设备	人力成本高，无法实现24h无人值守
用户体验差	入场后需自行摸索开关位置	降低消费体验，影响复购率
安全隐患	长时间无人时设备持续运行	加速设备老化，存在火灾隐患

1.2 解决方案：20A智能开关实现远程集中控制

将芯步20A智能开关（智能通断器AC4-20A）集成到桌游室的预约管理软件中，实现“用户扫码入场-自动通电开灯开空调；订单结束-自动断电报关”的自动化闭环。

核心价值

无人值守运营：用户自助扫码下单，系统自动控制包间供电
精准能耗管理：订单结束自动断电，杜绝能耗浪费
远程运维能力：经营者可通过后台随时查看设备状态、远程控制
降低改造成本：设备支持改造现有线路，无需重新布线

第二章：硬件选型与接口详解

2.1 芯步20A智能开关核心参数

本方案采用芯步智能通断器AC4-20A，这是一款支持HTTP API远程控制的工业级智能开关。

参数项	规格详情	桌游室场景优势
产品型号	UNI-AC4-20A	智能通断器，支持改造现有线路
额定电流	20A	可承载灯光+空调总功率
额定功率	4400W	满足包间所有电器同时运行
控制方式	HTTP API远程控制	无缝对接预约软件系统
联网方式	WiFi 2.4GHz	无需额外网关，即装即用
私有部署	支持自建消息服务器	数据不出本地，安全可控
按钮功能	可自定义/可屏蔽	支持保留物理开关或禁用

2.2 设备接线与安装要点

在桌游室场景中，通常将智能开关安装在包间的配电箱内，串联在总供电线路上：

接线步骤

关闭总闸，确认断电
将智能开关的火线输入端（L-IN）连接入户火线
将智能开关的火线输出端（L-OUT）连接包间电器线路
零线（N）直接并联（智能开关仅控制火线）
通电测试，确认设备联网成功

⚠️ 重要安全提示：接线前请确保断路器上的电源已关闭；由持证电工操作。

2.3 接口通信原理

设备采用标准的HTTP请求-响应模型。本质上是向指定URL发送一个带签名的POST请求来控制开关的通断。

请求地址格式

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

四个关键要素：

AppId：应用ID（平台生成）
AppSecret：开发者密钥（平台生成）
ts：当前Unix时间戳（秒级）
sign：动态签名，算法为 md5(md5(AppSecret) + ts)

第三章：软件对接完整流程

3.1 前置准备

步骤1：注册芯步账号

访问芯步官网，点击右上角“立即注册”
完成手机/邮箱验证

步骤2：创建工作台

登录后点击右上角“工作台”
点击“创建新的工作台”，填写基本信息

步骤3：添加设备

进入“物联网控制台”模块
添加设备，获取Device ID（如：1878）

步骤4：获取API凭证

在“开发设置”中获取AppID和AppSecret

3.2 签名算法详解（安全关键）

签名是通信安全的核心保障。算法采用双重MD5叠加时间戳

原始密钥(AppSecret)
    │
    ▼
[MD5加密] → 32位小写MD5值(md5_secret)
    │
    ▼
[拼接时间戳] → md5_secret + ts
    │
    ▼
[再次MD5加密] → 最终Sign值

公式:Sign = md5( md5(AppSecret) + ts )

关键要点

先对AppSecret做一次MD5，得到32位小写十六进制字符串
将结果拼接上ts时间戳（秒级）
对整个拼接字符串再做一次MD5
两轮MD5输出均为32位小写

3.3 核心命令接口

3.3.1 单路控制（基础开关）

控制智能开关的通断状态：

开启开关

"power1"：第1路输出
"1"：开启

关闭开关

"0"：关闭

3.3.2 状态保持功能（防误触）

在共享桌游室场景中，用户可能在房间内误按物理开关导致断电。可启用“状态保持”功能来解决此问题

保持开启状态（用户关闭后自动恢复）：

"keep":"1"：保持开状态
"revert":"3"：用户操作后3秒自动恢复

保持关闭状态（用户开启后自动恢复）：

3.3.3 先通后断功能（安全保护）

适用于某些需要预热或保护电器的场景：

"2000"：先通电2000毫秒后断电

3.3.4 先断后通功能（重启设备）

适用于远程重启路由器、监控摄像头等设备：

"2000"：先断电2000毫秒后恢复通电

3.3.5 多路控制

若使用多路控制器，可独立控制每一路：

批量控制多路：

同时关闭第1路和第3路

3.4 获取设备状态

除了控制设备，系统还可以查询设备当前状态，用于同步显示或异常监控：

第四章：实战代码实现

4.1 Python完整实现

# -*- coding: utf-8 -*-
import hashlib
import time
import requests
import json
from typing import Optional, Dict

# ========== 配置信息（从芯步控制台获取） ==========
APP_ID = "YOUR_APP_ID"          # 应用ID
APP_SECRET = "YOUR_APP_SECRET"  # 应用密钥
DEVICE_ID = "1878"              # 设备ID
# ===================================================

def calculate_md5(s: str) -> str:
    """计算MD5（32位小写）"""
    return hashlib.md5(s.encode('utf-8')).hexdigest()

def yoyo_control_switch(action: str, power_line: str = "power1") -> Dict:
    """
    控制智能开关通断
    
    参数:
        action: "on" 或 "off"
        power_line: 控制的线路，如 "power1", "power2", "power3", "power4"
    
    返回:
        接口响应字典
    """
    # 1. 获取当前时间戳（秒级）
    ts = int(time.time())
    
    # 2. 计算签名
    md5_secret = calculate_md5(APP_SECRET)
    sign_raw = md5_secret + str(ts)
    sign = calculate_md5(sign_raw)
    
    # 3. 构建请求URL
    url = f"https://api.thingboot.com/{APP_ID}/device/control/"
    params = {"sign": sign, "ts": ts}
    
    # 4. 构建命令
    command_value = "1" if action == "on" else "0"
    payload = {
        "device": DEVICE_ID,
        "order": {power_line: command_value}
    }
    
    # 5. 发送请求
    try:
        response = requests.post(url, params=params, json=payload, timeout=5)
        print(f"开关控制: {action} - {response.status_code}")
        return response.json() if response.ok else {"error": response.text}
    except Exception as e:
        print(f"请求失败: {e}")
        return {"error": str(e)}

def yoyo_set_keep_state(keep: str = "1", revert: str = "3") -> Dict:
    """
    设置状态保持（防止用户误触物理开关）
    
    参数:
        keep: "1"保持开状态（用户关后自动恢复），"0"保持关状态（用户开后自动恢复）
        revert: 自动恢复时间（秒）
    """
    ts = int(time.time())
    md5_secret = calculate_md5(APP_SECRET)
    sign = calculate_md5(md5_secret + str(ts))
    
    url = f"https://api.thingboot.com/{APP_ID}/device/control/"
    params = {"sign": sign, "ts": ts}
    payload = {
        "device": DEVICE_ID,
        "order": {"power1": {"keep": keep, "revert": revert}}
    }
    
    response = requests.post(url, params=params, json=payload, timeout=5)
    return response.json() if response.ok else {"error": response.text}

def yoyo_reset_device(interval: int = 2000) -> Dict:
    """
    远程重启设备（先断后通）
    
    参数:
        interval: 断电时长（毫秒），如2000=2秒
    """
    ts = int(time.time())
    md5_secret = calculate_md5(APP_SECRET)
    sign = calculate_md5(md5_secret + str(ts))
    
    url = f"https://api.thingboot.com/{APP_ID}/device/control/"
    params = {"sign": sign, "ts": ts}
    payload = {
        "device": DEVICE_ID,
        "order": {"reset1": str(interval)}
    }
    
    response = requests.post(url, params=params, json=payload, timeout=5)
    return response.json() if response.ok else {"error": response.text}

# ========== 业务场景:订单开始自动通电 ==========
def start_room_session(order_id: str, room_id: str):
    """用户下单后，自动开启房间供电"""
    print(f"订单{order_id}:房间{room_id}用户已入场")
    
    # 1. 开启开关
    result = yoyo_control_switch("on")
    
    # 2. 启用状态保持（防止用户误关）
    yoyo_set_keep_state(keep="1", revert="3")  # 用户关后3秒自动恢复
    
    # 3. 记录日志
    print(f"房间{room_id}供电已开启，状态保持已启用")
    return result

# ========== 业务场景:订单结束自动断电 ==========
def end_room_session(order_id: str, room_id: str):
    """订单结束后，自动关闭房间供电"""
    print(f"订单{order_id}:房间{room_id}用户已离开现场时")
    
    # 1. 关闭开关
    result = yoyo_control_switch("off")
    
    # 2. 可选:恢复默认状态保持设置
    # yoyo_set_keep_state(keep="0", revert="3")
    
    print(f"房间{room_id}供电已关闭")
    return result

# ========== 业务场景:超时订单自动断电 ==========
def timeout_check_and_close(order_id: str, room_id: str, duration_minutes: int):
    """订单超时检查，超时自动断电"""
    # 假设订单已超时
    print(f"订单{order_id}:房间{room_id}已超时{duration_minutes}分钟，自动断电")
    return end_room_session(order_id, room_id)

# 示例调用
if __name__ == "__main__":
    # 模拟用户下单
    start_room_session("ORD001", "101")
    
    # 模拟用户离开现场时结束订单
    # end_room_session("ORD001", "101")

4.2 Node.js实现

const crypto = require('crypto');
const axios = require('axios');

// 配置
const config = {
    appId: 'YOUR_APP_ID',
    appSecret: 'YOUR_APP_SECRET',
    deviceId: '1878',
    apiUrl: 'https://api.thingboot.com'
};

// 计算签名
function generateSign(secret, ts) {
    const firstMd5 = crypto.createHash('md5').update(secret).digest('hex');
    const signRaw = firstMd5 + ts;
    return crypto.createHash('md5').update(signRaw).digest('hex');
}

// 控制开关
async function controlSwitch(action) {
    const ts = Math.floor(Date.now() / 1000);
    const sign = generateSign(config.appSecret, ts);
    
    const url = `${config.apiUrl}/${config.appId}/device/control/`;
    const commandValue = action === 'on' ? '1' : '0';
    const payload = {
        device: config.deviceId,
        order: { power1: commandValue }
    };
    
    try {
        const response = await axios.post(url, payload, {
            params: { sign, ts },
            timeout: 5000
        });
        console.log(`开关已${action === 'on' ? '开启' : '关闭'}`);
        return response.data;
    } catch (error) {
        console.error(`控制失败: ${error.message}`);
        throw error;
    }
}

// 订单开始
async function startSession(orderId, roomId) {
    console.log(`订单${orderId}:房间${roomId}开始使用`);
    await controlSwitch('on');
}

// 订单结束
async function endSession(orderId, roomId) {
    console.log(`订单${orderId}:房间${roomId}结束使用`);
    await controlSwitch('off');
}

// 调用示例
// startSession('ORD001', '101');

4.3 Shell脚本实现（轻量级）

第五章：业务场景集成方案

5.1 系统设计

graph TB
    subgraph 用户端
        A[用户扫码/小程序]
    end
    
    subgraph 软件系统
        B[预约管理系统/WMS]
        B1[订单管理模块]
        B2[设备控制模块]
        B3[定时任务模块]
    end
    
    subgraph 芯步云平台
        C[HTTP API网关]
    end
    
    subgraph 硬件层[桌游室现场]
        D1[20A智能开关-包间101]
        D2[20A智能开关-包间102]
        D3[20A智能开关-包间103]
        E1[灯光/空调]
        E2[灯光/空调]
        E3[灯光/空调]
    end
    
    A --> B1
    B1 --> B2
    B2 --> C
    C --> D1
    C --> D2
    C --> D3
    D1 --> E1
    D2 --> E2
    D3 --> E3
    B3 --> B2

5.2 第一种场景：用户扫码入场自动通电

业务流程

用户通过小程序/APP下单支付
订单系统生成订单号，分配包间
系统调用芯步API，向该包间智能开关发送开启指令
包间灯光、空调自动启动
用户收到入场通知，直接进入使用

代码实现

5.3 第二种场景：订单结束自动断电

业务流程

用户点击“结束订单”或订单时间到
订单系统触发结束流程
系统调用芯步API，关闭对应包间智能开关
包间灯光、空调自动关闭
系统计算费用并完成扣款

代码实现

5.4 第三种场景：超时订单自动断电

业务流程

定时任务每5分钟扫描运行中的订单
检测订单开始时间与当前时间的差值
若超过预设时长（如超时15分钟），自动结束订单并断电
系统发送通知给用户

代码实现

5.5 场景四：远程运维与故障排查

业务流程

经营者通过管理后台查看所有包间设备状态
发现异常时可远程重启设备
设备离线时自动告警

代码实现

5.6 场景五：与预约时段联动

业务逻辑

用户预约了10:00-12:00的包间
系统在10:00自动开启供电
若用户提前到达扫码，按实际入场时间计费
12:00系统自动断电，防止超时占用

数据库设计示例

第六章：高级功能与应用扩展

6.1 多路独立控制方案

若桌游室需要分别控制灯光、空调、投影、音响等多路设备，可采用芯步4路控制器

6.2 能耗统计与分析

通过记录每次订单的用电时长，可进行能耗分析和成本核算：

6.3 智能省电策略

无人检测：集成红外传感器 + 智能开关，检测到房间无人10分钟自动断电
分时控制：灯光常开，空调根据室温自动调节
定时关闭：营业结束时间统一断电，防止遗漏

6.4 设备离线告警

第七章：最佳实践与故障排查

7.1 部署

部署要点	方案	原因
WiFi网络	选用企业级路由器，2.4GHz频段	穿墙能力强，覆盖范围广
设备数量	每个包间独立部署1台	实现分区域独立控制
物理开关	屏蔽或启用状态保持	防止用户误触导致断电
备用方案	保留手动机械开关	网络异常时可应急使用

7.2 代码层面注意事项

并发控制：同一设备相邻指令间隔≥500ms，避免接口限流
网络超时：设置合理的超时（5秒），避免阻塞主业务流程
错误重试：控制失败时实现重试机制（最多3次，间隔递进）
调用机制设计：重复下发相同命令不应产生副作用
日志记录：记录每次开关操作，便于故障排查对账

7.3 常见问题排查表

现象	可能原因	解决方案
设备显示离线	1. 电源断开2. WiFi密码错误3. 路由器禁用了设备MAC	1. 检查指示灯2. 重配网络3. 检查路由器白名单
接口返回403	签名计算错误	1. 检查AppSecret前后是否有空格2. 确保MD5为32位小写3. 检查ts与服务器时间误差
控制成功但灯不亮	1. 接线错误2. 灯本身损坏3. 线路过载保护	1. 检查接线2. 测试灯泡3. 检查功率是否超4400W
物理开关失效	未配置状态保持且误操作	重新通过API开启或配置状态保持
设备频繁断线	WiFi信号弱	增加AP或改用有线版本

第八章：总结

通过将芯步20A智能开关集成到共享桌游室的预约管理软件中，可以实现“用户自助入场-系统智能控电-订单结束自动断电”的完整无人化运营闭环。

核心要点回顾

硬件选型：20A/4400W智能通断器，承载灯光+空调无压力
接口对接：仅需发送带签名的HTTP POST请求，4行代码即可实现开关控制
签名算法Sign = md5(md5(AppSecret) + ts)，双重MD5保障安全
关键功能：状态保持防止用户误触、远程重启支持运维
场景覆盖：入场通电、离开现场时断电、超时保护、远程运维

对接工作量评估：熟练开发人员可在2小时内完成从注册到首个灯光控制的成功集成。

投资回报分析

按每个包间平均浪费2小时/天灯光空调计算，年省电费约800-1200元/间
10间包间的桌游室，约3-6个月即可收回硬件改造成本
实现24h无人值守，降低人力成本至少30%

让桌游室的每一个包间都“聪明”起来——用户扫码即来、离开现场时即关，经营者坐在家中即可轻松管理全场，这正是物联网赋能共享经济的价值所在。

第一章：场景痛点与解决概述

1.1 共享桌游室的运营管理挑战

1.2 解决方案：20A智能开关实现远程集中控制

第二章：硬件选型与接口详解

2.1 芯步20A智能开关核心参数

2.2 设备接线与安装要点

2.3 接口通信原理

第三章：软件对接完整流程

3.1 前置准备

3.2 签名算法详解（安全关键）

3.3 核心命令接口

3.3.1 单路控制（基础开关）

3.3.2 状态保持功能（防误触）

3.3.3 先通后断功能（安全保护）

3.3.4 先断后通功能（重启设备）

3.3.5 多路控制

3.4 获取设备状态

第四章：实战代码实现

4.1 Python完整实现

4.2 Node.js实现

4.3 Shell脚本实现（轻量级）

第五章：业务场景集成方案

5.1 系统设计

5.2 第一种场景：用户扫码入场自动通电

5.3 第二种场景：订单结束自动断电

5.4 第三种场景：超时订单自动断电

5.5 场景四：远程运维与故障排查

5.6 场景五：与预约时段联动

第六章：高级功能与应用扩展

6.1 多路独立控制方案

6.2 能耗统计与分析

6.3 智能省电策略

6.4 设备离线告警

第七章：最佳实践与故障排查

7.1 部署

7.2 代码层面注意事项

7.3 常见问题排查表

第八章：总结

通断器产品方案：

怎么接入DC-10A 设备电源控制器以实现远程定时任务控制

如何在创客项目电源控制场景中接入智能设备以实现远程参数配置管理

创客项目电源控制场景：怎样把智能通断器模块接入到软件项目中

怎样接入AC5-10A 低压控制开关来实现能耗数据统计控制

共享麻将馆灯光插座管理：怎么将DC-10A 电器开关集成到自己的项目中

共享桌游室场景方案：

共享桌游室灯光空调控制：如何将AC1-10A智能通断器集成到软件项目中

共享桌游室灯光空调控制：如何把AC4-10A电源开关接入到软件项目中

共享桌游室灯光空调控制：如何把智能控制器8路|交流电压版集成到软件项目中

共享桌游室灯光空调控制：怎样将AC1-10A智能通断开关对接到项目中

共享桌游室灯光空调控制：如何把AC4-30A 定时控制开关接入到项目中