共享台球厅的痛点是“无人值守不等于无人在场”——经常出现球桌空转、灯和空调忘关的情况。本文基于芯步壁挂式人体感应器的开放接口，给出完整的设备接入方案，从硬件选型、API对接机制到场景联动逻辑，帮你把“人来灯亮、人走电断”这件事落地。

1. 背景与选型依据

在24H共享台球厅的运营中，节能减排和智能化体验是痛点。传统的定时断电策略往往误判用户离开现场时或中途休息情况，导致台球桌灯光、空调长时间空转，电费成本居高不下。

为实现真正的“人来灯亮，人走电断”，我们选用芯步 智能人体存在红外和雷达传感器[壁挂] （型号：UNI-CGQ-RT-BG-HL）。该设备通过WiFi 2.4G直连网络，无需额外网关，且具备红外+雷达双模检测能力，能精准识别人体微动（如打球间隙的站立、吸烟动作），避免传统红外传感器因人体静止而误判为“无人”的尴尬。

2. 硬件集成架构

2.1 设备拓扑结构

• 感知层：壁挂式人体感应器（每个球桌区域部署1-2台，安装在侧墙离地2.5米处，避开空调出风口）。

• 执行层：智能断路器/继电器模组（控制球桌灯、排风扇）、红外遥控盒子（控制空调）。

• 网络层：场内2.4G WiFi网络（需确保信号覆盖无死角）。

• 平台层：自建或私有化部署的芯步消息服务器。

2.2 安装位置

3. 接入逻辑（HTTP API与消息推送）

芯步的硬件接口采用HTTP协议，支持任何后端语言（Java/Python/PHP/Node.js）调用，支持公网与局域网直连。

3.1 数据流向设计

1. 上行（感知） ：传感器检测到“有人/无人”状态变化时，主动向你的业务服务器推送状态。

2. 下行（控制） ：业务服务器根据业务逻辑，向智能开关/空调下发“开/关”指令。

3.2 关键接口定义

3.2.1 接收设备上报事件（Webhook）

设备状态变化时，芯步平台会向你预设的 callbackUrl 发送POST请求。

• 触发场景：红外雷达状态变更（infrared_target）。

• 数据解析示例

  { "device_id": "1670284239", "action_time": 1702512000, "msg_type": "event", "event_name": "infrared_detect", "data": { "infrared_target": 1, // 1:有人；0:无人 "radar_target": 1, // 1:雷达探测存在 "battery": 100 // 如适用 } }

• 服务器处理逻辑：收到 infrared_target:0（无人）且持续5分钟无变化时，触发关灯指令。

3.2.2 下发控制指令（控制灯具/空调）

你需要在后台调用芯步提供的控制接口来关闭设备。

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

• 请求方法：POST

• 请求体示例：关闭线路（灯光）

  { "device": "820720", // 受控的智能开关或插座ID "order": {"power": 0} // 0:关闭，1:开启 }

• 签名机制：将 AppId、AppSecret、ts（时间戳）拼接后MD5加密，防止接口被恶意调用。

3.3 自建消息服务器（私有化部署）

为了保障台球厅在网络波动时的响应速度，在本地局域网部署一台消息服务器。

• 优势：即使外网断开，传感器检测到有人后，局域网内的服务器依然能控制本地的灯光开关，不影响正常营业。

4. 业务逻辑：从“感知”到“联动”

4.1 第一种场景：精准自动照明（消除盲区）

• 逻辑

  • 用户入场：用户扫码开门后，系统自动启动该包间/区域的人体感应器。

  • 用户走动：传感器雷达模组检测到微动 $\rightarrow$ 上报 radar_target:1$\rightarrow$ 服务器查询当前订单状态“进行中” $\rightarrow$ 下发指令 power:1 给球桌灯开关。

  • 休息模式：如果用户去上厕所，红外检测无目标但雷达检测到微动（环境影响），系统保持灯光待机或进入低亮度模式，不执行断电。

  • 无人离开现场时：红外+雷达都报告 0 且持续10分钟 $\rightarrow$ 服务器下发关闭所有电源指令，并推送消息提醒用户或后台管理员。

4.2 第二种场景：防作弊与安防联动

• 逻辑

  • 非营业时段闯入：系统处于“布防”状态，传感器触发 有人 事件 $\rightarrow$ 服务器判定未查询到有效订单 $\rightarrow$ 联动声光报警器，并推送告警至管理员手机。

  • 滞留提醒：订单结束后，若传感器仍检测到存在，系统触发语音播报“感谢光临，请记得带好随身物品”，5分钟后仍未离开则上报滞留工单。

5. 高级配置：利用设备“配置项”优化体验

根据芯步的产品手册（物模型），该设备支持丰富的本地配置项，部分逻辑无需经过云端服务器，直接在设备内联动，响应速度可提升至毫秒级。

5.1 本地联动配置（联动模式）

在设备初始化时，通过API或后台进行如下配置：

• 红外开机状态：设置为 1（上电即启用检测）。

• 发现无人时线路动作 （relay_change_0） ：设置为 1（关闭）。

• 发现有人时线路动作 （relay_change_1） ：设置为 1（打开）。

效果：此时传感器直接物理控制后端继电器，即使你的服务器宕机，只要传感器通电，它就能自动控制台球灯的开闭，实现高可用的本地联动。

5.2 防抖动配置

为了避免台球撞击等震动导致的误触发（注意：雷达传感器不受声音影响，但红外受温度影响），需要配置去抖时间：

• 红外无人触发持续时间 （infrared_change_0） ：设置为 60 或 120 秒。即确认无人状态持续1-2分钟后才执行断电，避免用户开球瞬间的大幅度动作被误判。

6. 实施难点与规避方案

6.1 网络覆盖问题

• 难点：台球厅面积大，墙体多，WiFi信号衰减严重，导致传感器频繁掉线。

• 方案：采用MQTT over WebSocket或HTTP长轮询机制维持心跳。芯步设备支持设定5组WiFi网络，可在全屋部署Mesh组网，为每个传感器分配最近的AP。

6.2 多人/多桌干扰

• 难点：A桌传感器检测到B桌用户，导致A桌误关灯或一直亮灯。

• 方案：利用雷达的定向天线与距离过滤功能。在API对接时，只上报信号强度高于阈值（如 > -50dBm）的数据，或者通过物理屏蔽罩减少横向干扰。

6.3 固件与兼容性

• 难点：新采购的设备固件版本不一。

• 方案：通过芯步平台统一推送固件更新。根据手册提供的固件列表（如V6版本），确保所有传感器升级至支持“私有化”且稳定的版本（如 p3.20251226.v6），以维持指令集的一致性。

7. 总结

通过对接芯步的壁挂式智能人体感应器，共享台球厅可以低成本构建一套稳定的“人来灯亮、人走灯灭”系统。关键在于利用双模检测避免静态误判，利用HTTP API实现订单系统与硬件的闭环，并善用设备本地配置实现高可用的断网运行。这套方案不仅能降低30%以上的电费支出，还能提升用户的自助开台体验，真正实现24小时无人化精细管理。