共享麻将馆的远程管理痛点在于：如何实时知道哪个包间的灯或麻将机还开着、空调是否在浪费电。芯步的包间控制器通过全路数HTTP接口开放了这些状态查询能力，以下方案从设备选型、接口调用到业务集成给出完整路径。

1. 解决概述

在共享麻将馆的运营中，“灯忘了关”、“麻将机电源未切断”、“空调空转”是导致电费损耗和安全隐患的主要痛点。单纯的远程开关无法解决“开关状态未知”的焦虑——管理员需要确定设备是否真的响应了指令，用户也需要直观看到包间是否空闲。

本方案基于芯步（ThingBoot） 的智能包间控制器及开放接口，旨在为共享麻将馆构建一套“状态可视、远程可控、异常可查” 的灯光与插座管理系统。核心思路是通过标准的HTTP协议，将物理硬件状态（通断）数字化，无缝集成到现有的共享棋牌室小程序或SaaS管理后台中。

2. 硬件选型：智能包间控制器

在共享棋牌室场景中，无法简单依赖单个智能插座（容易丢失且管理分散），需要采用集成化的“包间控制器”。根据芯步的产品线，推荐以下两款硬件：

智能包间控制器 | Mini

• 适用场景：小型棋牌室（3-4个包间）、轻量级改造

• 回路设计：共4路输出

  • 第1路（16A）：控制包间主照明/换气扇

  • 第2路（16A）：控制麻将机插座供电（关键回路）

  • 第3路（10A）：门禁电磁锁控制（配合订单开门）

  • 第4路（30A）：空调专用回路（支持大功率）

• 技术优势：支持 WiFi 2.4G 直连，无需额外网关，降低硬件成本。

智能包间控制器 | Max

• 适用场景：高档商务包间、VIP房

• 回路设计：共8路输出

  • 优势：将照明、氛围灯、麻将机、饮水机、空调（多台）、排气扇完全独立控制，便于精细化统计电量消耗。

选型逻辑：每个包间部署一台该控制器，安装在麻将机桌下或墙壁暗盒中，替代传统的空气开关或墙壁开关位置，实现对包间内所有强电设备的集中管控。

3. 技术对接架构与接口应用

芯步平台的核心理念是 “HTTP API First” ，这意味着任何支持HTTP请求的后端语言（Java, Python, PHP, Go）或前端脚本均可直接调用，无需复杂的SDK集成。

3.1 接口基本调用规范

所有控制与状态查询指令均通过向 https://api.thingboot.com 发送POST请求完成。为了安全性，请求需携带签名（Sign）和时间戳（Ts）。

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

• 核心数据包结构

  { "device": "设备ID（如:820720）", "order": { "power1": 1, // 第1路继电器:1-开启，0-关闭 "power2": 0, // 第2路:0-关闭（麻将机断电） "power4": 1 // 第4路:空调开启 } }

3.2 关键功能实现：远程开关状态查询

这是本方案解决的痛点。传统方案只管“发指令”，不管“有没有执行”。借用芯步或兼容的开放协议（参考设备资源管理逻辑），我们需要实现双向状态同步。

由于设备具有记忆功能且状态实时，实现“开关状态查询”有两种技术路径：

方案 A：主动轮询模式（适合Web后台管理）

系统定时（如每30秒）向硬件发送状态查询指令，获取当前实际通断情况。

• 实现逻辑：调用查询设备资源接口。利用类似 query.resource.value 的 intent 机制，指定 resourceId 对应的回路状态。

• 应用场景：当用户手机信号不好时点击“关灯”，但指令未送达。管理员在后台点击“刷新状态”，系统显示“第2路（麻将机）实际状态：开启”，此时可触发重试机制。

方案 B：状态上报推送模式（适合实时小程序）

利用芯步平台的消息推送机制。

• 实现逻辑：当有人按动包间内的物理开关，或者设备因过载自动断电时，设备会主动上报状态变化到开发者预设的服务器地址（Callback URL）。

• 代码示意（接收推送）：开发者在服务端接收JSON数据：

  { "device_id": "xxxx", "status": { "power1": "off", "power2": "on" } }

• 应用场景：用户在手机上打开小程序，无需点击刷新，页面实时显示“麻将机已关闭”。

4. 场景：业务闭环流程

结合上述硬件与接口，典型的共享麻将馆业务流程如下：

第一步：用户下单（门禁与通电联动）

1. 用户下单：通过小程序支付。

2. 远程通电：服务器调用接口控制 Mini控制器的第2路（麻将机插座） 和 第1路（照明） 开启。

3. 状态验证（关键步骤）：系统自动调用“查询接口”读取第2路状态。如果返回 power2:1，反馈前端“准备就绪，请开门”；如果返回 0，系统判定设备离线或故障，自动通知运维并退款。

第二步：使用中（防耗电与超时提醒）

1. 无人检测联动：虽然控制器负责插座，但可结合芯步的“人体存在传感器”（探测范围更广，比红外更准）。当传感器探测到无人超过15分钟。

2. 服务器介入：后台收到传感器无人消息，向控制器发送 查询灯光状态 指令 。

3. 执行策略：若灯光为开，则发送TTS语音提醒（通过智能音柱）：“检测到包间无人，5分钟后将自动断电”，超时后关闭所有回路。

第三步：订单结束（全断电与结算）

1. 结束动作：订单倒计时归零。

2. 强制断电：服务器向 /device/control 发送全关指令：{"power1":0, "power2":0, "power4":0}。

3. 结算依据：利用接口查询空调回路（第4路）在整个订单周期内的“累计开启时长”，作为扣除电费的依据（如果实行电费自理模式）。

5. 接口集成优势与简易开发示例

芯步的设备在设计上极大降低了开发门槛，具备以下显著优势：

• 去网关化：设备直连Wi-Fi，只要场地有2.4G Wi-Fi信号即可，减少了网关这一故障点。

• 跨平台性：由于是HTTP接口，不仅后端可以调用，甚至可以在Shell脚本中直接使用curl命令进行调试。对于需要快速测试的开发人员，可以参考官方提供的示例代码（如PHP控制通断器逻辑）快速上线 MVP 版本。

开发示例（伪代码逻辑）

6. 总结

在共享麻将馆场景中，芯步的智能包间控制器系列产品最核心的价值并非仅仅是“远程开关”，而是开放了“状态查询”这一环。

• 对运营者：解决了“到底关了没有”的焦虑，减少了空置时的电费损耗。

• 对开发者：标准的HTTP API接口设计（如资源查询机制）让系统对接变得像调用普通网站一样简单，极大地缩短了开发周期。

通过集成该方案，共享棋牌室可以实现从“无人值守”到“智能无忧值守”的升级。