怎样在共享棋牌室设备控制中接入智能硬件来实现照明电源开关控制_解决方案

CATALOG

一、共享棋牌室智能改造的挑战与机遇

1.1 行业分析

共享棋牌室作为一种典型的无人值守商业模式，对照明和电源管理有着特殊的需求。传统运营方式存在以下痛点：

痛点维度	传统方式的问题	造成的后果
能源浪费	顾客离开现场时后忘记关灯关空调	电费流失，每包间月均损失50-100元
订单脱节	订单结束与设备断电不同步	顾客超时不走，新订单无法开始
人工成本	需专人定时巡视关电	增加运营人力成本
管理盲区	无法远程了解设备状态	设备故障不能及时发现

1.2 智能改造的核心价值

通过接入芯步智能硬件，实现“订单即控、人离电断”的自动化管理：

订单联动控制：用户扫码下单→自动通电开灯→订单结束→自动断电
多设备集中管理：一个包间内所有电器（照明、麻将机、空调、饮水机）统一管控
远程可视可控：经营者随时随地查看设备状态，远程处理异常
无人值守运营：降低人力成本，支持7×24小时营业

1.3 适用场景

场景类型	核心需求	本方案适配度
棋牌室/茶楼包间	控制灯光、麻将机、空调、排风	高适配
台球室球台	控制球台照明灯	高适配
自助麻将房	计时收费+自动断电	高适配

二、硬件选型方案

2.1 核心推荐：智能包间控制器|Mini

这款设备是棋牌室包间场景的“标准配置”，专为服务型门店包间设计

参数项	规格说明
控制路数	4路独立输出，覆盖包间所有电器
第1路	16A开关，接照明/换气扇/吸烟灯
第2路	16A插座接口，接饮水机/麻将机
第3路	10A门禁接口，接电磁锁/电插锁
第4路	30A插座接口，接2匹空调
工作电压	DC 5V1A（直流）
无线连接	WiFi 2.4GHz
语音播报	TTS版本支持远程语音（订单提醒/服务说明）
产品尺寸	72×90×62.8mm（小巧，可装入电箱）
外壳材质	防火V0级PC

选型优势

一机控全屋：一台设备覆盖包间内所有电器，无需多个设备
即插即用：WiFi直连，无需网关
语音可选：TTS版本可播报订单开始/结束提醒
开放API：HTTP接口对接任意业务系统

2.2 多包间部署方案

包间数量	设备选型	部署方式
1-10个包间	每包间1台Mini控制器	独立控制，互不干扰
10-30个包间	Mini控制器 + 集中管理后台	云端统一管理
30+包间	Mini控制器 + 自建服务器	私有化部署，数据自控

2.3 备选设备对比

场景需求	推荐设备	说明
仅控制照明（多路）	智能照明控制器4路	4路照明独立控制
控制多个球台照明	智能控制器8路	单设备控8张球台
改造现有插座	WiFi墙壁插座	直接替换原有插座
改造现有开关	WiFi墙壁开关	平行替换原有墙壁开关

三、API对接详解

3.1 接口基础信息

芯步提供统一的RESTful API，所有控制命令均通过HTTP POST发送

项目	说明
请求地址	`POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}`
Content-Type	`application/json`
响应时间	80-120ms
认证方式	MD5签名认证

参数说明

{AppId}：应用ID，注册后在控制台获取
sign：请求签名，计算方式见下文
ts：当前Unix时间戳（秒）

3.2 签名算法

签名机制防止接口被恶意调用，所有请求必须携带正确签名

3.3 Mini控制器命令速查表

智能包间控制器|Mini 支持以下控制命令

功能	命令格式	说明	示例
第1路控制	`{"power1":"1"}`	1开0关	照明/换气扇
第2路控制	`{"power2":"1"}`	1开0关	麻将机/饮水机
第3路控制	`{"power3":"1"}`	1开0关	门禁电磁锁
第4路控制	`{"power4":"1"}`	1开0关	空调
批量控制	`{"batch":{"relay":[1,2,3,4],"power":1}}`	多路同时控制	一键全开/全关
先通后断	`{"point1":"300000"}`	开启后延时关闭	延时5分钟关灯
TTS播报	`{"play:gbk:16":"欢迎光临"}`	语音播报	订单提醒

贴心提示：如果平时只开照明，可以给顾客留个物理开关。把传统墙壁开关接入控制器的DI接口，顾客按键开关时，控制器会上报到服务器，业务系统收到后执行“翻转逻辑”，这样顾客想关灯时按一下就行，不需要每次都掏手机。

3.4 代码示例

Python完整实现

import hashlib
import time
import requests
import json

class KTVRoomController:
    """棋牌室包间控制器"""
    
    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.api_base = "https://api.thingboot.com"
    
    def _generate_sign(self, ts: int) -> str:
        """生成API请求签名"""
        first_md5 = hashlib.md5(self.app_secret.encode()).hexdigest()
        return hashlib.md5((first_md5 + str(ts)).encode()).hexdigest()
    
    def _send_command(self, order: dict) -> dict:
        """向设备发送命令"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        payload = {"device": self.device_id, "order": order}
        response = requests.post(url, json=payload, timeout=5)
        return response.json()
    
    # ========== 单路控制 ==========
    def light_on(self):   return self._send_command({"power1": "1"})  # 开灯
    def light_off(self):  return self._send_command({"power1": "0"})  # 关灯
    
    def mahjong_on(self): return self._send_command({"power2": "1"})  # 麻将机开
    def mahjong_off(self):return self._send_command({"power2": "0"})  # 麻将机关
    
    def ac_on(self):      return self._send_command({"power4": "1"})  # 空调开
    def ac_off(self):     return self._send_command({"power4": "0"})  # 空调关
    
    def lock_on(self):    return self._send_command({"power3": "1"})  # 门禁开锁
    def lock_off(self):   return self._send_command({"power3": "0"})  # 门禁关锁
    
    # ========== 批量控制 ==========
    def all_on(self):
        """全开:照明+麻将机+门禁+空调"""
        return self._send_command({"batch": {"relay": [1, 2, 3, 4], "power": 1}})
    
    def all_off(self):
        """全关"""
        return self._send_command({"batch": {"relay": [1, 2, 3, 4], "power": 0}})
    
    # ========== 场景功能 ==========
    def start_order(self, duration_minutes: int = 2):
        """订单开始:开灯+开麻将机+开空调，延时关灯"""
        self.all_on()
        # 延时关灯（防止顾客离开现场时忘关）
        self._send_command({"point1": str(duration_minutes * 60 * 1000)})
        return {"status": "success", "message": f"包间已开启，照明将在{duration_minutes}分钟后自动关闭"}
    
    def end_order(self):
        """订单结束:关所有设备"""
        return self.all_off()
    
    def voice_broadcast(self, text: str):
        """语音播报"""
        return self._send_command({"play:gbk:16": text})

# ========== 使用示例 ==========
controller = KTVRoomController(
    app_id="YOUR_APP_ID",
    app_secret="YOUR_APP_SECRET",
    device_id="YOUR_DEVICE_ID"      # 例如:100001
)

# 场景1:顾客下单开台
controller.start_order(duration_minutes=120)

# 场景2:语音提醒
controller.voice_broadcast("您的包间时间还剩15分钟，如需续费请扫码")

# 场景3:订单结束关电
controller.end_order()

Node.js实现

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

class RoomController {
    constructor(appId, appSecret, deviceId) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.deviceId = deviceId;
        this.apiBase = 'https://api.thingboot.com';
    }
    
    generateSign(ts) {
        const firstMd5 = crypto.createHash('md5').update(this.appSecret).digest('hex');
        return crypto.createHash('md5').update(firstMd5 + ts).digest('hex');
    }
    
    async sendCommand(order) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this.generateSign(ts);
        const url = `${this.apiBase}/${this.appId}/device/control/?sign=${sign}&ts=${ts}`;
        
        const response = await axios.post(url, {
            device: this.deviceId,
            order: order
        });
        return response.data;
    }
    
    // 订单开始
    async startOrder(durationMin = 120) {
        await this.sendCommand({ batch: { relay: [1, 2, 4], power: 1 } });  // 开灯+麻将机+空调
        // 延时关灯（防忘关）
        await this.sendCommand({ point1: String(durationMin * 60 * 1000) });
    }
    
    // 订单结束
    async endOrder() {
        return this.sendCommand({ batch: { power: 0 } });
    }
}

cURL命令行示例

四、订单系统联动设计

4.1 整体业务流程图

sequenceDiagram
    participant 用户
    participant 小程序
    participant 业务后端
    participant 芯步API
    participant Mini控制器
    participant 包间设备
    
    用户->>小程序: 扫码选择包间/时长
    小程序->>业务后端: 创建订单
    业务后端->>业务后端: 扣款/生成订单
    
    Note over 业务后端: 订单生效
    业务后端->>芯步API: 全开命令
{batch:{power:1}}
    芯步API-->>业务后端: 命令下发成功
    业务后端->>Mini控制器: 下发指令
    Mini控制器->>包间设备: 通电开灯/开麻将机/开空调
    
    Note over Mini控制器: 计时开始（设备本地延时）
    Mini控制器->>芯步API: 上报状态
    芯步API->>业务后端: 推送状态消息
    
    Note over 业务后端: 订单倒计时结束前5分钟
    业务后端->>芯步API: 语音提醒
{play:gbk:16:"时间快到了"}
    芯步API->>Mini控制器: TTS播报
    Mini控制器->>用户: "剩余5分钟，请续费"
    
    Note over 业务后端: 订单结束
    业务后端->>芯步API: 全关命令
{batch:{power:0}}
    业务后端->>业务后端: 生成账单
    业务后端->>小程序: 推送消费记录

4.2 核心联动逻辑

订单开始 → 自动通电

用户扫码支付后，业务系统调用芯步API：

开启第1路（照明）
开启第2路（麻将机/饮水机）
开启第4路（空调）
可选：延时关灯设置（防止顾客离开现场时忘关）

订单结束 → 自动断电

订单倒计时归零后，业务系统调用全关命令
可设置延后几分钟关灯，给顾客缓冲离开现场时时间

中途续费 → 延长供电

用户续费后，重新下发延时命令
可播报语音确认：“续费成功，已为您延长XX分钟”

五、设备安装与部署

5.1 接线方案

Mini控制器提供4路输出，接线方式如下

输出端口	接入设备	接线说明
第1路 (L1/N1)	照明灯/换气扇	火线接入L1，零线接N1
第2路 (L2/N2)	麻将机/饮水机插座	火线接入L2，零线接N2
第3路 (L3/N3)	门禁电磁锁	直流12V输出
第4路 (L4/N4)	空调插座	火线接入L4，零线接N4

电源接入

控制器供电：DC 5V1A适配器
WiFi配置：2.4GHz频段

5.2 多包间部署架构

门店网络拓扑:
├── 路由器（企业级，覆盖全店）
│   │
│   ├── 包间1 ── Mini控制器（192.168.1.101）
│   ├── 包间2 ── Mini控制器（192.168.1.102）
│   ├── 包间3 ── Mini控制器（192.168.1.103）
│   └── 包间N ── 按需扩展
│
└── 管理后台（云端/本地）

5.3 配网流程

设备通电，等待指示灯
搜索WiFi热点 YO-XXXX
连接该热点，访问 192.168.4.1
选择门店WiFi并输入密码
配网成功，在控制台获取设备ID

注意事项

确保WiFi为2.4GHz频段（不支持5GHz）
设备与路由器距离不超过15米（无遮挡）
固定IP分配，便于管理

六、总结

对比维度	传统方式	芯步本方案
控制方式	人工到现场操作	云端API远程控制
订单关联	无法自动对接	订单即控，自动通断电
设备集成	多设备独立	一机控全屋（4路）
状态感知	无法远程查看	实时获取设备状态
语音能力	无	TTS版本支持语音播报
改造成本	需改造整套线路	集中控制，接线简单
系统对接	封闭系统	HTTP API全开放

通过芯步智能包间控制器|Mini + 开放HTTP API，共享棋牌室可以快速构建一套：

一机控全屋：照明、麻将机、空调、门禁，4路独立控制
⏱️ 订单联动：下单自动通电、结束自动断电
语音播报：订单提醒、续费通知，提升用户体验
即装即用：WiFi直连，无需网关，快速部署

完整的API文档、设备规格书和演示环境，请访问芯步官网或联系技术支持团队。