共享台球室的痛点在于无人值守时的设备电源管理——用户下单后需自动通电、超时后需断电、异常状态需远程复位。以下方案基于芯步智能分体控制箱的开放接口，详细说明从设备选型到接口对接的完整流程。

1. 项目概述与选型背景

在共享台球室的无人值守场景中，经营者面临的痛点是如何确保用户在下单后能立即获得台球桌的照明、空调等设备的供电，并在订单结束后及时切断电源，防止资源滥用和能源浪费。

针对这一需求，芯步提供的智能WiFi控制器或智能分体控制箱是理想的解决方案。其中，智能分体控制箱因其“成品装箱出厂、多线路独立控制（最高24路）、单路负载高达5000W”的特性，特别适合台球室这种需要控制多张台球桌照明、排风扇及空调的场景。

本方案的目标是详细阐述如何利用芯步硬件开放的HTTP接口，将远程通断功能无缝集成到现有的共享台球室小程序或SaaS管理系统中。

2. 硬件选型：核心设备解析

在实施前，我们需要明确对接的硬件——智能分体控制箱的技术参数，这对于后续的开发至关重要。

• 产品形态：成品控制箱，内部已预装继电器和电路，现场只需接入220V电源和负载线路即可。

• 控制能力：支持8至24路继电器输出。在台球室场景，通常1路对应1张台球桌的顶灯，1路对应排风扇，另预留几路控制茶水间或公共区域灯光。

• 负载要求：单路最大支持25A/5000W（阻性负载），完全满足台球厅金卤灯或LED灯的启动需求。

• 联网方式有线以太网和Wi-Fi。考虑到台球室通常具备Wi-Fi覆盖，优先使用有线网络以确保控制指令的稳定性。

• 核心优势开放HTTP接口。无需复杂的私有协议（如Modbus或Zigbee），直接通过HTTP请求即可下发指令，极大降低了开发门槛。

3. 系统设计

为了实现“用户扫码开灯 -> 订单结束关灯”的全自动化，系统架构分为四层：

1. 感知/执行层：芯步智能控制箱。安装在台球室的配电箱内，通过继电器触点控制台球桌灯具的零火线通断。

2. 网络层：控制箱通过Wi-Fi/4G连接至芯步云平台。这一层负责设备状态的上下行传输。

3. 芯步云平台层：作为设备的中台，负责处理设备心跳、指令转发和设备状态缓存。它为开发者提供了统一的RESTful API入口。

4. 应用层（你的项目）：包括用户端小程序（扫码开灯）、商家管理后台（查看设备状态）和后端服务器（核心调度逻辑）。

4. 接口对接开发详解

这是本方案的核心部分。假设你已经完成了设备的配网，并能在芯步后台看到设备处于“在线”状态。

4.1 准备工作：获取凭证与设备ID

在芯步开放平台中，你需要获取以下关键信息：

• AppKey / AccessToken：每次调用接口的身份凭证。

• Device ID：目标控制箱的唯一标识（例如 FB1020392）。

• Channel Number：需要控制的继电器通道号（例如 power1 代表1号台球桌灯）。

4.2 核心接口调用逻辑

芯步硬件支持标准的HTTP命令下发，接口设计简洁。以下是针对台球室最常用的几个操作场景：

第一种场景：用户下单成功 - 开启指定设备

当用户在小程序支付成功后，后台服务器应向芯步云平台发起请求，打开对应台球桌的灯光。

• 请求方式POST

• URL示例https://api.yoyoiot.com/ordercontrol

• 请求体示例 (JSON)

• 参数解析

  • device_id：控制箱的ID。

  • channel：控制箱上对应的线路编号。根据产品资料，命令通常对应 power1 至 power24。

  • statuson为闭合继电器（通电），off为断开继电器（断电）。

第二种场景：订单结束/超时 - 批量关闭设备

当用户点击“结束订单”或订单倒计时归零时，系统需要切段该用户使用的所有设备（灯、电视、空调）。

• 特殊指令：除了逐路关闭，控制箱支持批量控制指令。

• 请求体示例

(注：具体批量指令格式需参考芯步最新的API文档，通常为 batch 参数)。

第三种场景：设备异常恢复 - 先断后合

在设备死机或需要复位时，可以使用“先断后合”指令，类似于物理重启。

• 指令类型reset （先断后合）。

• 应用场景：如果发现台球桌灯偶发性不亮，系统可自动执行 reset 指令（断开->等待1秒->闭合），实现远程维护。

4.3 状态同步机制

为了确保小程序上显示的“灯状态”与物理世界一致，你需要处理设备状态同步：

• 主动查询：定时或点击时调用 GET /orderstatus/{device_id} 获取当前各路通断状态。

• 被动接收：芯步平台通常支持Webhook配置。配置后，当设备状态变化（物理按键按下或远程控制成功），平台会主动推送到你的服务器地址，保障实时同步。

5. 项目实施流程

在共享台球室的实际布线中，请遵循以下步骤进行落地：

1. 电路改造：将台球桌的照明电路原有线路切断，接入到芯步智能控制箱的继电器输出端。控制箱的输入端接总闸。

2. 网络配置：将控制箱通过网线连接到台球室的路由器，或配置Wi-Fi连接。

   • 关键点：确保静态IP或DHCP配置正确，且网络能访问芯步公网域名。如果网络不稳定，使用有线连接。

3. 点位映射：在管理后台建立一张映射表：设备ID (FB1020392) + 通道 (power1) 对应 房间A桌1。

4. 业务逻辑闭环

   • 支付成功：调用接口 power1 ON。

   • 剩余1分钟提醒：通过语音硬件（也可利用控制箱蜂鸣器或独立语音播报器）提醒用户。

   • 订单结束：调用接口 power1 OFF。

   • 紧急情况：店员在后台点击“紧急断电”，调用对应线路 OFF。

6. 常见问题与优化

• 关于延迟：HTTP公网请求会有约200ms-500ms的延迟，这对开灯场景完全无感。如果需要极速响应，芯步部分设备支持局域网（LAN）IP直接控制，可在同一路由器下直接通过内网IP调用接口，几乎零延迟。

• 关于断网：如果Wi-Fi断开，控制箱是否还能工作？

  • 选用支持本地定时或断网执行的型号。即在配置中设定：若检测到某路通电后，1小时后自动断电。这可以作为云端控制离线时的备用物理逻辑。

• 安全性：接口调用请一定要在后端进行。严禁在前端小程序代码中暴露 AppKey，防止恶意用户抓包后通过构造请求非法控制全店电源。

7. 总结

通过对接芯步的智能控制箱，共享台球室可以轻松实现“无人的电源管理”。该方案利用HTTP接口的普适性和易用性，大幅缩短了开发周期。开发者只需关注业务逻辑（订单状态机），将开灯/关灯动作对应为 power{x}=on/off 的HTTP请求发送即可。这种软硬解耦的模式，是当前共享经济领域最高效、最稳定的技术实现路径之一。