共享台球室的痛点很明确：用户离开现场时忘关灯和空调、夜间无人值守时设备空转、电费损耗大。芯步这款24路控制器通过HTTP接口开放了设备控制能力，可以把它无缝集成到你的预约计费系统中，实现“订单开始即通电、订单结束即断电”的自动化闭环。以下是具体的集成方案：

1. 解决概述

在共享台球室场景中，通常一个球房拥有多张球桌（例如10-20张），每张球桌上方需要独立的照明灯光，而整个区域（或分区）需要空调控制。

逻辑架构：

1. 设备层：24路控制器分别连接 1-N 号球桌的灯光回路，以及空调（风机盘管或大功率空调接触器）回路。

2. 业务层：你的后端系统（SaaS/小程序后端）负责处理用户支付、订单状态。

3. 交互层：用户小程序负责展示设备状态、发起控制指令。

核心流程：用户扫码 -> 支付/验票 -> 后端接收“订单开始”事件 -> 后端调用芯步开放接口 -> 控制器闭合对应第X路的开关 -> 灯亮/空调开。

2. 准备工作：设备选型与接线

要将“智能24路分体远程通用控制器”（型号：UNI-KZQ-TY-24）集成进来，首先要确保物理链路是通的。

• 设备参数

  • 工作网络：2.4G WiFi 。设备直接连接球馆路由器，无需额外网关。这意味着你需要确保球馆WiFi信号覆盖稳定。

  • 控制能力：24路继电器输出。你可以将其中的20路分配给20张台球桌的灯光，剩余4路分配给不同区域的空调总控。

  • 负载注意：灯光通常没问题，但空调整机启动电流较大。如果直接控制大功率空调，在控制器后端增加交流接触器，用控制器的“小电”去控制接触器的“大电”，这样更安全。

• 场景布线

  • 灯光：将每一盏台球灯的火线剪断，两端分别接入控制器一路的“COM”和“NO”接口。零线直接并联，无需通过控制器。

  • 空调：如果是分体式空调，利用控制器控制空调插座的通断电（需配合空调开启“记忆”功能）；如果是中央空调，利用控制器控制风机盘管电磁阀。

3. 集成开发核心：接口对接

芯步开放平台的核心优势在于 “HTTP API直接调用” 。这意味着不管你的后台是用Java、Python、Go还是PHP写的，只要能发HTTPS请求，就能控制设备。

集成三步走：

第一步：设备上云与获取凭证

1. 将24路控制器通电并连接到球馆WiFi。

2. 在芯步开发者后台添加该设备，获取唯一的 Device ID（设备ID）。这是你后续发指令的身份标识。

3. 申请 Access Key / API Key：作为调用接口的签名密钥，保证安全性。

第二步：核心接口调用逻辑

你主要需要对接以下两个核心接口：

1. 单路控制接口（最常用）这是集成中最核心的功能，用于单独控制某一张球桌的灯光。

• 请求地址https://api.yoyoiot.com/ordercontrol

• 请求方法：POST

• 主要参数

  • device_id: 那台24路控制器的ID。

  • channel: 路数，值为 1 到 24（例如指定第5张桌子的灯，则传5）。

  • status: 0 或 1（0为关闭，1为开启）。

• 业务对接代码逻辑示例（伪代码）

  # 当用户在小程序点击"开台"或支付成功后 def on_order_start(user_id, table_number): # table_number 假设为 5，代表第5桌 device_id = get_config("TB_24CH_DEVICE_ID") # 调用芯步接口 response = http POST https://api.yoyoiot.com/ordercontrol \ headers={"Authorization": "Bearer " + API_KEY} \ body={ "device_id": device_id, "channel": table_number, # 第5路 "status": 1 # 通电，灯亮 } if response.success: log("开灯成功") else: alert("设备离线或故障")

2. 全控/批量控制接口用于下班统一清场，或营业结束时一键关闭所有灯和空调。

• 参数：可以一次性发送一个24位的二进制字符串，如 "000...111"，或者通过循环调用单路接口，但使用设备自带的批量指令以减少网络延迟。

第三步：状态同步与异常处理

• 状态查询：为了防止APP显示状态与实际情况不符（例如有人手动按了设备上的按钮），你需要定时调用设备状态查询接口，或者利用芯步平台的消息推送机制。当设备状态被物理改变时，平台会主动推送消息到你的服务器，秒级同步。

• 离线处理：24路控制器依赖WiFi。如果网络断了，接口调用会失败。在你的后台应捕获此异常，并向管理员发送“XX球馆设备离线”的告警通知。

4. 场景功能深化：从“开关”到“智能”

有了基础的开关控制还不够，结合台球室场景，可以做以下优化，这就是你项目的亮点：

• 灵活计费策略下的精准供电

  • 预付费模式：用户下单支付 -> 开灯，时间倒计时归零 -> 关灯。这需要你的服务器有一个定时任务，或者在用户下单时设定一个延时关闭任务（利用设备自带的定时任务功能会更稳定）。

  • 后付费模式：用户扫码先开灯，打完球点击“结账” -> 计算时长扣费 -> 关灯。如果用户忘记点击结账，利用 “人感逻辑”：虽然控制器本身不一定带人体传感器，但你可以集成第三方传感器，或者简单粗暴地设定“凌晨2点后所有未关设备自动强制关闭”的节能策略。

• 套餐打包（灯光+空调）假设球房有VIP区和非VIP区。将24路中的第21路定义为“VIP空调总阀”，第22路定义为“普通区空调总阀”。当用户预定VIP包时，除了开灯，自动调用API开启第21路，空调得电运转。用户走后，关灯同时关空调，彻底解决“人走空调忘关”的电费刺客问题。

• 门禁联动如果你用的是该系列的Max型号（通常包含门禁锁接口），可以实现：新用户下单 -> 开门锁 -> 进房间 -> 系统自动检测到门锁状态变化 -> 自动开灯开空调。实现完全无接触入场。

5. 部署与运维注意事项

在实际落地中，为了确保这套系统稳定运行，有几个关键点需要注意：

1. WiFi信号质量：24路通过WiFi联网，网络稳定性即是生命线。强烈每个球房部署企业级AP（无线接入点），而不是家用路由器。如果WiFi掉线，用户无法开灯/关灯，会导致严重客诉。

2. 电源管理：控制器是弱电设备（5V/12V），但控制的是220V强电。在配电箱里，强弱电要分开走线，避免干扰。

3. 私有化部署选项：芯步支持私有化部署。如果你的球房连锁店对数据隐私要求比较高（比如不想经过芯步的公有云），可以将消息服务器部署在你自己的机房，设备数据直接发到你的内网服务器，实现物理隔离。

4. 防雷与浪涌保护：24路设备通常装在配电箱内，在总进线处加装防浪涌保护器，防止夏天雷击损坏设备。

总结

通过将 芯步24路控制器 的 HTTP 接口集成到你的共享台球室管理系统中，你可以实现：

1. 硬件成本优化：一台设备管24张桌，单点成本极低。

2. 运维提效：彻底解决长明灯和长转空调的浪费问题，实现真正的24h无人值守。

3. 开发友好：标准的 HTTP 接口降低了物联网开发门槛，让你的核心开发人员可以专注在复杂的计费营销业务上，而非关注复杂的 MQTT 底层协议。