共享麻将馆门禁照明联动：怎么把1路86型墙壁开关集成到自己的项目中_解决方案

CATALOG

一、解决概述

共享麻将馆/棋牌室的核心运营模式是 “无人值守、自助消费” 。顾客通过小程序预约下单，系统自动分配房间、下发门禁开锁指令，并同步为房间内的电器（麻将机、空调、灯光）通电。

这个流程中，“门禁”与“照明”的联动是关键——顾客扫码开门的那一刻，灯光应自动亮起，而不是让顾客摸黑找开关。传统方案需要在每个房间部署独立控制器，成本高、布线复杂。

本方案利用芯步1路86型智能墙壁开关的HTTP接口能力，结合门禁电磁锁控制器，将共享麻将馆的门禁系统与照明控制无缝打通，实现真正的 “开门即亮灯” 无人化体验。

核心价值

门锁联动：顾客扫码开门瞬间，灯光自动开启，无需手动操作
低成本部署：标准86型开关直接替换原有墙壁开关，无需重新布线
⚡ 大功率承载：单路10A/2200W，可覆盖麻将馆照明、排风扇等设备
零网关：2.4G WiFi直连，无需购买额外网关设备

二、核心技术能力分析

2.1 产品规格

芯步智能墙壁开关1路专为照明和电器控制设计，参数如下

类别	特性说明
产品型号	UNI-KG-1
安装方式	标准86型底盒安装（可直接平行替换原有墙壁开关）
控制路数	1路独立输出
工作电压	100-250V AC（交流/市电）
额定电流	MAX 10A
负载功率	300-1200W（LED/节能灯等感性负载需＜300W）
待机功耗	0.4W（断开）- 1W（接通）
产品尺寸	宽：86mm；长：86mm；厚：41mm
无线连接	WiFi 2.4GHz 直连，无需网关
控制协议	开放标准HTTP接口，任何编程语言均可对接
部署模式	支持公有云API或私有化部署（局域网控制）

2.2 核心命令表

1路开关支持以下命令，是实现照明联动控制的基础

命令类型	JSON格式示例	功能说明（联动关键）
照明开启	`{"power1":"1"}`	开启照明/电器
照明关闭	`{"power1":"0"}`	关闭照明/电器
状态保持	`{"power1":{"keep":"1","revert":"5"}}`	强制保持照明开启，用户手动关灯5秒后自动恢复
先通后断	`{"point1":"3000"}`	开启后3秒自动关闭（临时照明用）
先断后通	`{"reset1":"3000"}`	关闭后3秒自动恢复（临时断电用）

⚠️ 状态保持功能的价值：在麻将馆场景中，这个功能可以锁定关键区域照明，防止顾客离开现场时时误关灯导致下一位顾客进错房间。

2.3 API接口签名规则

芯步设备控制采用HTTP请求，使用动态签名验证

请求地址:https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方法:POST
Content-Type: application/json

签名算法:
md5_secret = md5(AppSecret)
sign = md5(md5_secret + ts)

参数说明:
- AppId:应用ID（在开发者控制台获取）
- AppSecret:开发者密钥
- ts:当前Unix时间戳（秒）

请求Body示例

三、共享麻将馆门禁照明联动方案

3.1 整体架构

在共享麻将馆场景中，采用“包间控制器+开关”的组合方案。如果只需要简单的门锁照明联动，也可以直接用智能开关控制照明，门锁独立联网。

┌─────────────────────────────────────────────────────────────────┐
│                        共享麻将馆包间                            │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                    原有线路                              │   │
│  │  ┌─────────────────┐    ┌─────────────────┐            │   │
│  │  │  智能墙壁开关   │    │  照明设备       │            │   │
│  │  │  (86型墙壁安装) │───▶│  (主灯/射灯)    │            │   │
│  │  └─────────────────┘    └─────────────────┘            │   │
│  └─────────────────────────────────────────────────────────┘   │
│                          ▲                                      │
│                          │ HTTP API联动                          │
│                          │                                      │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                    门禁电磁锁                            │   │
│  │  (门锁控制器，扫码开门时触发)                            │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  网络:2.4G WiFi                                                │
└─────────────────────────────────────────────────────────────────┘
                                       │
                                       │ 小程序预约 → 支付 → 开门
                                       ▼
┌─────────────────────────────────────────────────────────────────┐
│                     共享麻将馆云平台                             │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                    订单管理模块                          │   │
│  │  - 预约下单                                             │   │
│  │  - 支付确认                                             │   │
│  │  - 时段管理                                             │   │
│  └─────────────────────────────────────────────────────────┘   │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                    设备控制模块                          │   │
│  │  - 开门时自动调用:light_on(room_id)                    │   │
│  │  - 订单结束时自动调用:light_off(room_id)               │   │
│  └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

3.2 硬件安装步骤

步骤1：开关安装

拆卸包间原有86型墙壁开关
安装芯步智能墙壁开关1路（86型底盒直接平行替换）
接线方式与普通开关一致（火线L、零线N、灯控线L1）

步骤2：门锁配置

确保门禁电磁锁控制器已接入网络
记录门锁控制器的设备ID（用于联动触发）

步骤3：网络配置

确保包间内WiFi信号覆盖（设备仅支持2.4G频段）
通过芯步控制台为开关配网

步骤4：获取凭证

登录
获取 AppId 和 AppSecret
记录开关的设备ID，与包间号建立映射关系

3.3 代码集成示例

以下提供Python和PHP两种语言的完整对接示例。

Python实现（推荐用于后端服务）

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

class MahjongRoomController:
    """共享麻将馆房间控制器类"""
    
    def __init__(self, app_id: str, app_secret: str):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_base = "https://api.thingboot.com"
    
    def _generate_sign(self, ts: int) -> str:
        """生成API签名:sign = md5(md5(AppSecret) + ts)"""
        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, device_id: str, order: Dict) -> Optional[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": device_id, "order": order}
        try:
            response = requests.post(url, json=payload, timeout=5)
            return response.json()
        except Exception as e:
            print(f"命令发送失败: {e}")
            return None
    
    # ========== 照明控制（核心联动方法） ==========
    def light_on(self, device_id: str) -> Optional[Dict]:
        """开启房间照明（开门时调用）"""
        return self._send_command(device_id, {"power1": "1"})
    
    def light_off(self, device_id: str) -> Optional[Dict]:
        """关闭房间照明（订单结束时调用）"""
        return self._send_command(device_id, {"power1": "0"})
    
    # ========== 状态保持（防止误关灯） ==========
    def lock_light_on(self, device_id: str, revert_seconds: int = 5) -> Optional[Dict]:
        """
        锁定照明为开启状态
        即使用户手动关灯，revert_seconds秒后也会自动重新开灯
        适用场景:防止顾客离开现场时时误关灯导致下一位顾客进错房间
        """
        return self._send_command(device_id, {
            "power1": {"keep": "1", "revert": str(revert_seconds)}
        })
    
    # ========== 临时照明（延时自动关闭） ==========
    def temp_light_on(self, device_id: str, duration_ms: int = 30000) -> Optional[Dict]:
        """
        临时开启照明，指定时间后自动关闭
        适用场景:测试或临时照明需求
        """
        return self._send_command(device_id, {"point1": str(duration_ms)})

# ========== 使用示例 ==========
# 初始化（请替换为实际的AppId和AppSecret）
controller = MahjongRoomController("YOUR_APP_ID", "YOUR_APP_SECRET")

# 房间与设备ID映射表
ROOM_DEVICES = {
    "room_101": "1878",
    "room_102": "1879",
    "room_103": "1880",
}

# 联动函数:用户扫码开门时调用
def on_door_unlock(room_id: str):
    """门禁开锁回调函数"""
    device_id = ROOM_DEVICES.get(room_id)
    if device_id:
        # 开启照明
        controller.light_on(device_id)
        print(f"{room_id} 照明已开启，顾客入场")
        
        # 可选:锁定照明（防止顾客离开现场时误关灯）
        # controller.lock_light_on(device_id, revert_seconds=5)

# 联动函数:订单结束时调用
def on_order_end(room_id: str):
    """订单结束回调函数"""
    device_id = ROOM_DEVICES.get(room_id)
    if device_id:
        # 关闭照明
        controller.light_off(device_id)
        print(f"{room_id} 照明已关闭，房间待清洁")

PHP实现（适用于ThinkPHP等框架）

<?php
// 共享麻将馆照明控制服务类
class MahjongLightService {
    
    private $appId = 'YOUR_APP_ID';      // 在芯步控制台获取
    private $appSecret = 'YOUR_APP_SECRET';
    private $apiBase = 'https://api.thingboot.com';
    
    /**
     * 生成API签名
     */
    private function generateSign($ts) {
        $md5Secret = md5($this->appSecret);
        return md5($md5Secret . $ts);
    }
    
    /**
     * 发送控制命令
     */
    private function sendCommand($deviceId, $order) {
        $ts = time();
        $sign = $this->generateSign($ts);
        $url = "{$this->apiBase}/{$this->appId}/device/control/?sign={$sign}&ts={$ts}";
        
        $payload = json_encode([
            "device" => $deviceId,
            "order" => $order
        ]);
        
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 5);
        
        $response = curl_exec($ch);
        curl_close($ch);
        
        return json_decode($response, true);
    }
    
    /**
     * 开启照明（开门联动）
     */
    public function lightOn($deviceId) {
        return $this->sendCommand($deviceId, ["power1" => "1"]);
    }
    
    /**
     * 关闭照明（订单结束时调用）
     */
    public function lightOff($deviceId) {
        return $this->sendCommand($deviceId, ["power1" => "0"]);
    }
    
    /**
     * 锁定照明（防止顾客误关灯）
     */
    public function lockLightOn($deviceId, $revertSeconds = 5) {
        return $this->sendCommand($deviceId, [
            "power1" => ["keep" => "1", "revert" => (string)$revertSeconds]
        ]);
    }
}

// 使用示例
$lightService = new MahjongLightService();

// 用户扫码开门时调用
function handleDoorUnlock($roomId) {
    global $lightService;
    $roomDeviceMap = [
        "room_101" => "1878",
        "room_102" => "1879",
    ];
    
    $deviceId = $roomDeviceMap[$roomId] ?? null;
    if ($deviceId) {
        $lightService->lightOn($deviceId);
        // 可选:锁定照明
        // $lightService->lockLightOn($deviceId, 5);
    }
}

// 订单结束时调用
function handleOrderEnd($roomId) {
    global $lightService;
    $roomDeviceMap = [
        "room_101" => "1878",
        "room_102" => "1879",
    ];
    
    $deviceId = $roomDeviceMap[$roomId] ?? null;
    if ($deviceId) {
        $lightService->lightOff($deviceId);
    }
}
?>

3.4 完整业务流程

sequenceDiagram
    participant 顾客
    participant 小程序
    participant 云平台
    participant 门禁锁
    participant 智能开关
    participant 照明

    顾客->>小程序: 预约包间并支付
    小程序->>云平台: 提交订单
    云平台->>云平台: 记录订单，分配房间
    顾客->>小程序: 到达后扫码开门
    小程序->>云平台: 请求开锁
    云平台->>门禁锁: 下发开门指令
    云平台->>智能开关: 调用light_on(room_id)
    智能开关->>照明: 开启照明
    门禁锁-->>顾客: 门锁打开
    照明-->>顾客: 灯光亮起
    顾客->>顾客: 进入包间开始使用
    
    Note over 云平台: 订单时间结束前10分钟
    云平台->>智能开关: 可选:发送催场提醒
    
    Note over 云平台: 订单时间结束
    顾客->>小程序: 订单结束/自动结束
    云平台->>智能开关: 调用light_off(room_id)
    智能开关->>照明: 关闭照明
    云平台->>门禁锁: 锁门

四、典型应用场景

4.1 扫码开门自动亮灯（标准联动）

场景：顾客到达包间门口，扫描二维码开门，系统自动开启包间照明。

4.2 订单结束自动关灯（无人化运营）

场景：顾客使用时间结束，系统自动关闭包间照明和门锁。

4.3 状态保持防误触

场景：顾客离开现场时时可能顺手关灯，导致下一位顾客扫码开门后照明不亮。使用状态保持功能锁定照明。

五、集成步骤

步骤一：硬件采购与安装

根据包间数量采购智能墙壁开关1路
由电工在包间内更换开关（86型底盒直接平行替换原有开关）
确保门禁电磁锁控制器已安装并联网

步骤二：平台配置

登录
获取 AppId 和 AppSecret（在开发设置中获取）
为每个开关配网，记录设备ID，建立包间-设备映射表

步骤三：后端集成

将上述MahjongRoomController类集成到共享麻将馆管理系统中
在门禁开锁接口中调用light_on()
在订单结束回调中调用light_off()

步骤四：测试验证

模拟下单→开门流程，验证灯光是否自动开启
验证订单结束是否自动关灯
验证手动关灯后是否能按需恢复

六、总结

优势	说明
门锁照明联动	扫码开门瞬间灯光自动亮起，真正无人化体验
零改造安装	标准86型底盒直接替换原有开关，无需重新布线
大功率承载	10A/2200W额定能力，可覆盖麻将馆所有照明设备
状态保持	可锁定关键包间照明，防止顾客误关灯
HTTP开放接口	API签名算法简单，任何编程语言均可对接
零网关	WiFi直连，无需购买额外网关设备
私有化部署	支持纯局域网运行，满足内网安全要求

七、注意事项

负载限制 ⚠️：LED灯、节能灯等感性负载需控制在300W以内
WiFi信号：确保包间内WiFi信号良好（设备仅支持2.4G频段）
API响应说明：返回code:200仅表示平台接收指令，不代表设备执行成功
专业安装：涉及强电操作，必须由持证电工按照安全规范安装

通过以上方案，你可以快速将芯步智能墙壁开关1路集成到共享麻将馆管理系统中，实现“扫码开门即开灯、订单结束自动关灯”的门禁照明联动。如有疑问，可访问获取详细产品手册和技术支持。