共享棋牌室的无人化管理，核心落地环节之一就是灯光和插座的可控化。AC1-10A智能通断器通过HTTP接口可以无缝接入现有软件系统，实现订单驱动的自动化控制。以下从设备选型、接口集成、业务逻辑到异常处理，给出完整方案。

解决方案：基于芯步AC1-10A的共享麻将馆灯光插座智能集成方案

1. 项目概述与选型依据

在共享麻将馆（无人值守棋牌室）场景中，痛点是商家需要远程控制包间电源，并在订单结束后自动断电。传统的解决方案需要布设复杂的网关或更换专用面板，成本较高且施工麻烦。

方案核心：采用芯步 UNI-TDQ-AC1-10A 智能通断器。该设备是一款支持 WiFi 直连（2.4GHz）的单路通断控制器，无需额外购买网关即可独立运行。

选型优势

• 接口开放性：彻底摒弃传统的App手动控制模式，采用HTTP API作为控制通道，支持任何后端语言（Java, Python, PHP, Go）调用。

• 负载能力：额定电流10A，峰值16A，足以覆盖麻将馆的灯光（LED约30W）、麻将机（约200W）以及饮水机、普通插座（约1500W）的需求。

• 体积与安装：模具体积极小，可直接隐藏在传统的86底盒内（安装在开关或插座背后），实现“存量开关智能化”。

2. 集成设计

为了实现无人化管理，软件系统需要构建一个“业务触发硬件”的闭环。

• 物理架构

  • 设备层：每个包间部署若干台AC1-10A模块。推荐方案：1路控制总灯光，1路控制麻将机插座，1路控制总电源或空调。

  • 网络层：设备通过WiFi直连路由器（无需网关）。

  • 业务层：您的SaaS系统（小程序/管理后台）作为控制中枢。

• 数据流逻辑

  1. 用户端：用户在小程序下单支付。

  2. 业务后台：系统通知订单生效，调用芯步开放API。

  3. 硬件响应：AC1-10A通电，包间亮灯、麻将机得电。

  4. 结束逻辑：订单倒计时结束（或用户点击退场），后台再次调用API执行断电。

3. 详细集成步骤

步骤一：设备注册与网络配置

1. 获取凭证：在[芯步开放平台]注册开发者账号，获取 AppId 和 AppSecret（用于签名）。

2. 配网：使用官方提供的配网协议（或简易配网App），将AC1-10A模块连接至麻将馆现场2.4G WiFi。记录下系统分配的唯一标识：Device ID。

3. 映射关系：在您的软件数据库中，建立包厢与 Device ID 的绑定关系（例如：Room 101 -> Device ID: 820720）。

步骤二：接口调用实现（核心代码逻辑）所有控制命令通过 HTTP POST 请求发送至 http(s)://api.thingboot.com/{AppId}/device/control/。接口依赖 sign签名 和 ts时间戳 进行鉴权，防止接口被恶意篡改。

以下是一个标准的 “开灯/通电” 指令伪代码实现：

步骤三：状态同步与回调（进阶功能）为了确保软件界面显示的状态与物理设备一致，集成 WebSocket 或 消息推送 机制。

• 场景：当工作人员因检修在物理开关上手动断电时，芯步云平台会通过预设的回调URL，主动推送设备状态变更消息到您的服务器。

• 好处：避免出现“软件显示已开，实际设备已关”的订单纠纷。

4. 业务场景：订单生命周期管理

这是共享麻将馆运营的核心逻辑，您需要在软件中实现以下自动化策略：

第一种场景：用户下单/预约时段开始

• 触发条件：用户支付成功，订单状态变为“进行中”，且距离开始时间还剩 3 分钟。

• 执行动作：系统调用 control_light(device_id, 1)。

• 逻辑细节：为防止误操作，可以在接口调用前增加一层判断：只有在订单有效期内，才允许执行通电指令。

第二种场景：临场加时（续费）

• 触发条件：用户在手机端点击“续费”，支付成功。

• 执行动作：系统更新本地订单过期时间戳，无需发送任何指令（因为设备一直处于通电状态）。

• 例外：如果系统设计了“断电预警”提醒（例如提前5分钟闪烁灯光），续费成功后应发送取消预警的指令。

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

• 触发条件：订单剩余时间为0，且用户未续费。

• 执行动作：调用 control_light(device_id, 0)。

• 安全冗余：采用双保险机制。除了调用API外，您的服务器应设置一个定时任务（Cron Job），每分钟扫描一次所有进行中的订单，若发现订单时间已过期，再次触发断电指令，确保即使第一次API调用因网络抖动失败，也能在1分钟内强制断电。

5. 控制指令与参数配置

根据共享麻将馆的特殊需求，AC1-10A支持自定义动作，这为灯光管理提供了高级玩法

• 瞬开模式：默认 {"power": 1}，持续通电。

• 点动模式（触发开关） ：适用于控制门禁或复位设备。

  • 场景：用户点击小程序“开门”，模块接通1秒后自动断开。

  • 指令{"point": 1000} （毫秒）

• 先通后断：适用于一些需要先通电触发启动，然后断开待机的老旧麻将桌。

• 延迟关闭：用户离开现场时关灯后，如果还有传感器检测到人体存在，可强制发送延时关闭指令，防止误关。

6. 异常处理与运维

在实际的共享棋牌室运营中，经常遇到“用户关不掉”或“开不了”的问题，解决方案如下：

1. 断网重连机制：AC1-10A支持存储5组WiFi配置。确保现场网络覆盖，且设备固件保持最新。如果发生WiFi断线，设备会维持断电前的状态（通常是保持现状），您的API调用会返回超时错误，此时需在软件端提示“设备离线，请检查网络”。

2. 多设备协同控制

   • 如果单个包间灯光和插座是分开控制的，在软件后台建立“场景”。

   • 例如：“开场场景”需依次执行 灯光开 -> 插座开 或并发调用。

   • 注意：由于HTTP请求是异步的，并发调用可能会对WiFi模块造成轻微延迟，但在1-2秒内均可完成响应。

3. 私有化部署（可选） ：

   • 如果您的客户对数据隐私要求比较高（如高端私人会所），AC1-10A支持纯局域网环境运行。您的软件系统可以部署在场内服务器，不经过外网云平台，直接通过局域网IP对设备进行控制，延迟可降至50ms以内。

7. 总结

通过集成芯步AC1-10A，共享麻将馆系统能够以最低的硬件改造成本（无需砸墙改线，直接串联）实现最核心的无人值守功能。该方案的核心价值在于利用 HTTP API 将“订单流”与“电流”无缝结合，不仅提升了用户自助体验（扫码即用），更降低了商家运营电费损耗（离开现场时断电）。