共享麻将馆灯光插座管理：怎样把AC4-30A 电源控制模块接入到软件项目中_解决方案

CATALOG

共享麻将馆场景中，灯光、麻将机、空调等设备的远程控制是实现“无人值守”的关键。AC4-30A是一款支持HTTP接口的30A大功率通断器，适合接入总闸或空调回路。以下方案详细说明从硬件安装到软件集成的完整流程。

一、解决概述

在共享麻将馆的智能化改造中，除了灯光控制，空调、麻将桌电源和新风系统 的远程管理同样关键。AC4-30A电源控制模块 的最大优势在于其支持 30A大电流（约6600W），不仅能控制单路灯光，更能稳定承载一台2匹空调或整桌麻将机的负载。

本方案的目标是通过调用芯步开放平台的标准 HTTP API接口 ，将 AC4-30A 模块无缝集成到你的“共享麻将馆 SaaS 系统”或“小程序后端”中，实现订单与电源状态的联动。

二、硬件选型与场景映射

在实际的棋牌室包间部署中，根据控制对象选择对应的硬件：

控制对象	推荐硬件	接口类型	核心优势
照明/排风扇	智能墙壁开关（2路/3路）	HTTP/ MQTT	直接替换传统开关，美观且支持多路独立控制
麻将机插座	AC4-30A 智能通断器	HTTP/ MQTT	6600W大功率承载、可隐藏安装在插座底盒或配电箱内
空调/总闸	AC4-30A 或智能包间控制器	HTTP/ MQTT	具备16A或30A继电器，可直接切断空调电源，彻底省电
门禁锁	单路通断器	HTTP/ MQTT	控制电磁锁通电吸合或断电开门

为什么选择 AC4-30A 控制“麻将机/空调”？普通智能插座额定电流多为10A，带不动空调或老旧麻将机的电感负载，容易烧毁。AC4-30A 支持 6600W阻性负载 / 1100W感性负载，无需中间继电器，安全性更高。

三、接入软件项目的详细步骤

要把 AC4-30A 接入你的软件项目，无需关心底层无线协议，只需聚焦于 HTTP 接口调用。流程图如下：

sequenceDiagram
    participant User as 用户端小程序
    participant Server as 棋牌室业务后端
    participant Yoyo as 芯步云平台
    participant Device as AC4-30A 硬件

    User->>Server: 1. 点击"开台/通电"
    Server->>Server: 2. 生成签名(Sign)
    Server->>Yoyo: 3. POST /device/control/ (含设备ID, 命令power=1)
    Yoyo-->>Server: 4. 返回 {"code":200}
    Yoyo->>Device: 5. 下发指令(通过WiFi)
    Device->>Device: 6. 继电器吸合，灯/麻将机通电
    Device-->>Yoyo: 7. 上报执行结果(异步)
    Yoyo-->>Server: 8. 推送命令执行结果(可选)
    Server-->>User: 9. 更新界面状态: "已通电"

1. 环境准备与凭证获取

首先需要在芯步开发者平台完成以下配置：

注册账号并创建“工作台”。
在“物联网控制台”中，添加你的 AC4-30A 设备（通过设备上的二维码或ID进行配网绑定）。
获取关键凭证：
- AppID：标识你的项目。
- AppSecret：用于接口加密的密钥。
- Device ID：AC4-30A 模块的唯一标识（通常是一串数字）。

2. 接口鉴权（签名计算）

芯步的接口通过 Sign 签名 来保证安全性。你需要在后端编写一个公共函数，每次请求前动态生成 Sign。

Sign 生成逻辑（伪代码）

将你的 AppSecret 进行一次 MD5 加密，得到 encrypted_secret。
获取当前的 Unix 时间戳（秒） ts。
将 encrypted_secret 与 ts 拼接成字符串，再进行一次 MD5 加密。
最终得到的字符串即为 sign。

注：时间戳 ts 需要作为参数一并发送，且与签名计算时使用的保持一致，防止他人篡改请求。

3. 核心 API 调用：控制设备通断

集成过程中最核心的动作是向 AC4-30A 下发指令。该设备的控制指令通常为 power，参数 1 代表接通，0 代表断开。

接口信息

URLhttps://api.thingboot.com/{AppID}/device/control/
Method：POST
Query Stringsign={计算出的签名}&ts={时间戳}

请求体示例（JSON格式）

业务逻辑落地在你的后端代码中（例如 Node.js, Java Spring, Python Flask 或 PHP），你只需针对“开台”和“锁单/结账”两个动作，分别调用上述接口（传参 power=1 或 power=0）即可。

开台场景：用户支付成功 -> 后端调用接口 power=1 -> 麻将桌上电 -> 灯光亮起。
超时/结账场景：订单结束前5分钟提醒 -> 时间到 -> 后端调用接口 power=0 -> 自动断电。

4. 高级与批量控制

多设备管理：如果一个包间有多个 AC4-30A 模块（如1个控灯，1个控空调），你可以一次性控制它们。
- 请求参数示例："device": "123456,789012"。
- 命令参数示例："order": {"power": 0} （会将这两个设备同时关闭）。
分组控制：如果包间数量较多，在云平台设置“分组”（如：888包间组）。直接调用 分组控制接口 (/group/control/)，可以一键关闭整个包间的所有设备。

四、共享场景下的优化

状态同步与轮询（可选）虽然 HTTP 请求返回 code 200 代表指令下发成功，但为了确保硬件确实执行（例如 WiFi 信号不好导致执行失败），你可以利用平台的 设备状态查询接口 或 消息推送回调，来获取设备的实时通断状态并更新到你的管理后台。
本地化部署（可选）如果你对网络延迟要求比较高，或者运营的棋牌室网络环境复杂，AC4-30A 支持 局域网 HTTP 控制。如果你的服务器和硬件在同一个局域网内，可以不经过云端，直接在局域网内发送请求进行控制，响应速度更快。
负载安全提醒AC4-30A 虽然支持 30A 电流，但在共享麻将馆场景中，如果多台空调并接或麻将机老化可能出现短路。在软件中设置“电流/功率阈值告警”逻辑（需配合特定电测模块），当功率异常时自动触发 API 断电，保护设备安全。

五、总结

通过将 AC4-30A 电源控制模块 接入软件项目，你需要做的仅仅是：

物理安装：将模块串联进麻将机或空调的电源线路中。
代码集成：在你的后端代码中，编写一个调用 https://api.thingboot.com/.../device/control/ 的函数，并正确计算 Sign 签名。

整个过程无需复杂的嵌入式开发，通过标准的 HTTP 协议即可完成“硬件+软件”的闭环，实现共享空间的无人化运营。