共享麻将馆的痛点是“人效”——一个服务员同时看多个包间、处理订单启动和断电、应对临时续费。芯步的开放接口恰好能将这些离散动作串联成自动化流程。以下方案聚焦于如何通过HTTP API实现门禁、照明、麻将机的分组联动控制。

1. 背景与需求分析

在共享麻将馆（无人值守棋牌室）的运营场景中，痛点在于如何实现“人未到，电全通；人一走，电全断”的自动化管理。传统的管理模式依赖于人工巡检，不仅效率低，且容易出现忘记关灯、空调浪费、麻将机未断电等问题。

核心需求：

1. 设备分组控制：经营者需要将同一包间内的门禁、照明、麻将机、空调视为一个“逻辑组”，实现一键启动或关闭，而非逐个操作。

2. 门禁与电源联动：用户扫码开门瞬间，包间内照明自动亮起，麻将机通电；用户点击离店或超时结束后，门禁自动锁定并切断除服务器外的所有电源。

3. 环境感知联动：结合传感器实现“人来灯亮、人走灯灭”的节能效果，或在包间内检测到烟雾（吸烟）时自动启动排风扇。

2. 系统设计

基于芯步的智能硬件生态，本方案采用“云+端”的轻量化架构。

• 感知与控制层

  • 智能包间控制器：作为核心设备，负责控制麻将机、照明、空调、排风扇的通断。

  • 电磁锁/门磁：接入控制器的门禁接口，控制出入。

  • 智能传感器：人体存在雷达、烟雾传感器，用于环境侦测。

• 网络传输层：设备通过WiFi 2.4GHz或4G联网，通过HTTP/HTTPS协议与云端通信。

• 平台层：芯步开放平台。负责设备鉴权、指令转发、数据存储。

• 业务应用层（SaaS）：共享麻将馆管理系统（小程序/后台）。负责订单逻辑、设备分组管理、指令下发。

3. 硬件选型与分组策略

要实现有效的联动与控制，需根据负荷选择合适的硬件。

分组逻辑说明利用芯步开放平台的控制台功能，将物理位置相邻的硬件（控制器的线路1、线路2、线路3...）在云端绑定为一个虚拟设备组。例如：Room_01_Group 包含 Device_ID (控制器) 下的 power1（照明）、power2（麻将机）、power3（门磁）。

4. 核心联动场景与接口实现

本方案的核心在于利用HTTP请求调用芯步的API https://api.thingboot.com/{AppId}/device/control/，实现对分组设备的精准控制。

4.1 第一种场景：用户扫码开门（三秒全开）

流程图：用户小程序下单支付 -> 云端获取订单授权 -> 下发开门指令 -> 门锁打开 -> 照明与麻将机通电。

接口实现方案当后台系统接收到“订单开始”信号后，需依次发送以下请求（或利用批量控制命令）：

1. 开门与供电控制门禁线路闭合（power3=1）并延时放开，同时确保总电源（power1, power2）开启。

   // 请求地址: https://api.thingboot.com/AppID/device/control/ { "device": "882341234", // 该包间控制器设备ID "order": { "power1": 1, // 照明线路接通 "power2": 1, // 麻将机/插座线路接通 "power3": 1 // 门禁线路瞬时接通（开锁） } }

4.2 第二种场景：人走灯灭（节能模式）

联动机制：利用“智能人体存在雷达传感器”探测。

• 判断逻辑：若在预设时间（如15分钟）内，传感器持续上报“无人”状态，则系统自动向控制器下发指令关闭照明。

• 实现代码逻辑业务服务器接收传感器消息 {"radar_enable": 0} (无人) -> 计时 -> 发送关闭指令。

  // 服务器下发的关闭指令 { "device": "882341234", "order": {"power1": 0} // 仅关闭照明，保留麻将机和空调待机 }

  传感器数据上行机制参考芯步消息推送说明。

4.3 第三种场景：订单结束/超时断电

流程：用户点击“退房”或订单倒计时归零 -> 系统校验无续费 -> 执行全断电操作。

由于门禁需要维持断电开锁或通电开锁的特定逻辑（视锁型而定），此处通常先断电，再单独给门禁信号确保用户可离开。

1. 关闭所有电器

   // 批量将所有线路置为0 { "device": "882341234", "order": {"power1": 0, "power2": 0, "power4": 0} // 关闭照明、插座、空调 }

2. 语音播报提醒若控制器带TTS语音功能，可在断电前30秒播放提示音。

   // 接口调用示例 { "device": "882341234", "order": {"play": "gbk:16:订单即将结束，请收拾物品"} }

5. 技术要点

5.1 签名鉴权机制

所有API调用均需携带动态签名，防止恶意攻击。签名算法为：Sign = md5( md5(AppSecret) + ts )这确保了即使在公网传输，设备控制指令也难以被篡改。

5.2 定时任务与本地联动

• 网络抖动处理：芯步的智能控制器支持在云端设置“定时任务”。例如，即便服务器宕机，设备也可根据内置时钟在凌晨2点自动切断所有电源，作为二次安全保护。

• 局域网直连：针对网络要求高的场景，开放接口支持局域网IP直连，降低指令延迟。

5.3 状态反馈闭环

解决“灯到底开了没有”的痛点。通过订阅设备上报的实时状态，可在管理员后台生成日志。例如，当传感器上报烟雾浓度超标时，系统自动记录该包间曾有吸烟行为。

6. 方案效益分析

• 人力成本降低：实现100%无人值守，一个管理员通过手机端即可管理数十个包间。

• 能耗节约：通过“人走灯灭”和订单结束全断电策略，对比传统24小时常开模式，预计可节约电能30%-40%。

• 用户体验提升：用户扫码即玩，无需等待服务员开锁，隐私性和便捷性大幅提高。

7. 总结

芯步的开放接口体系通过标准化的HTTP API，将原本复杂的硬件控制转变为简单的软件调用。在共享麻将馆场景中，通过引入 “智能包间控制器” 作为核心执行单元，配合 “人体传感器” 与 “电磁锁” ，开发者仅需在后端进行简单的逻辑编排（If-Then-Else），即可快速实现高可靠性的门禁照明联动及设备分组控制，助力传统棋牌室快速向智能化、无人化转型。