共享台球厅人体感应联动：怎样将吸顶安装人体感应器集成到自己的项目中_解决方案

CATALOG

共享台球厅的痛点是“人走了，灯和空调还开着”——电费流失加上设备空转，单店每月可能多支出上千元。芯步的吸顶人体传感器支持HTTP直连，无需网关，探测到无人状态后可主动上报到你的服务器，再由服务器控制相关设备断电。以下是具体的集成方案。

1. 行业挑战与解决概述

在24小时无人值守的共享台球厅场景中，最核心的运营痛点在于 “人走电未断” 导致的能源浪费和设备损耗。球房面积大、包厢多，仅依赖用户离开现场时时的主动操作或定时断电，不仅体验差，而且容易引发客诉（如正在打球时突然熄灯）。

为了解决这一问题，我们提出基于 芯步智能人体存在传感器 的自动化联动方案。该方案利用毫米波/红外传感技术，精准检测台球桌周边的人员活动状态，并通过开放的HTTP接口与您的现有SaaS系统（小程序/后台）无缝集成，实现“人来灯亮、人走断电”的智能化管理。

2. 硬件选型与特性

在芯步的传感器产品线中，针对共享台球厅的高空吸顶安装需求，推荐选用具备广角探测和微动检测能力的设备。

推荐型号：UNI-CGQ-RT-XD-H

根据产品手册，该设备是专为吸顶安装设计的人体存在传感器，具备以下核心优势

供电与负载能力：支持 AC 100-250V 市电直接输入。这意味着它可以直接串联在灯光的回路中，自带一路 2200W阻性负载 输出，能直接控制台球厅的无影灯，无需额外继电器。
探测机制：虽然基础版为红外感应，但结合其接口定义，配合雷达版本可实现静态人体存在检测。它能区分“有人活动”和“有人静止”（如趴在桌上休息），避免打球中途误判关灯。
安装便捷性：吸顶设计，直接替换或安装于天花吊顶，探测范围覆盖球桌区域。

*注：若场景需要更高的静态探测灵敏度（如检测在沙发上睡觉的用户），选用同系列的雷达版本（UNI-CGQ-LD-XD），其可探测4米内的呼吸级微动。*

3. 系统架构与数据流设计

要将传感器集成到您自己的共享台球管理项目中，无需依赖芯步的公有云控制台。芯步设备开放HTTP接口，支持 “设备直连服务器” 模式。

3.1 架构原理

设备直连：传感器通过WiFi 2.4G直接连接球场路由器（无需网关），并配置唤醒您的业务服务器地址。
上行推送：当人体状态从“无人”变为“有人”，或从“有人”变为“无人”时，传感器主动向您的服务器发送HTTP POST请求。
下行控制：您的服务器根据业务逻辑（如订单状态、时间段），通过HTTP接口反向控制传感器自带的继电器输出，或控制其他网络设备（如空调控制器）。

3.2 时序图逻辑

sequenceDiagram
    participant 传感器
    participant 业务服务器
    participant 门禁/小程序
    participant 受控设备

    传感器-->>业务服务器: 1. 状态上报 (有人/无人)
    业务服务器->>小程序: 2. 同步状态 (展示在线)
    业务服务器->>传感器: 3. 下发指令 (开/关灯)
    传感器->>受控设备: 4. 物理电路通断

4. 详细集成步骤

4.1 硬件安装与接线

场景：以一张台球桌为例。

强电线接入：从配电箱引来火线和零线，接入传感器的 “输入L/N” 端。
灯具控制线：将台球灯的火线控制线接入传感器的 “输出” 端。
- 配置：将传感器设置为“无人延时”模式。但为了更智能，不直接开启硬件物理开关，而是将物理开关常开，由软件通过API控制继电器。

4.2 设备网络配置与服务器回调设置

芯步的设备支持自定义数据上报地址，这允许设备脱离官方云，直接对接您的私有服务器。

配置回调URL：在设备配网阶段（通常通过AP配网或扫码），将数据上报地址指向您的API端点。
- 结构示例https://您的域名.com/api/yoyo/callback
数据格式处理：服务器端需开发接口接收JSON数据包。
- 关键字段解析device (设备ID)，status (occupancy_status: 1有人/0无人)，timestamp。

4.3 云端业务逻辑联动（核心）

单纯的感应开关灯适用于洗手间，但在收费的台球厅，必须结合订单系统，防止未付费用户蹭台。

伪代码逻辑示例（Node.js/Python思路）：

4.4 接口调用实现

当服务器需要主动查询状态或控制设备时，调用芯步的开放API。

请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求Body示例（关闭设备电源）：
{ "device": 820720, // 传感器设备ID "order": {"power": 0} // 0=关闭输出，1=开启输出 }

5. 技术点优化

5.1 防误判机制

红外 vs 雷达：纯红外传感器对静止不动的人体会判定为“无人”。如果台球厅允许用户在沙发上休息或看球，必须选用雷达版（探测微动），或者采用“红外+雷达”“双模”版。雷达版能检测到呼吸带来的胸腔起伏，确保人在场时不断电。
延时上报：为了避免用户短暂离开（如去柜台买水）导致设备频繁开关，代码中应实现 “二次确认逻辑” 。即传感器上报“无人”后，等待2分钟，若再次确认是“无人”，再执行断电。

5.2 节能与安全策略

联动空调：通过传感器判断全场无人超过10分钟，通过HTTP接口调用智能插座或中央空调网关，自动关闭风机盘管，节能可达30%以上。
安防布防：在营业时间（凌晨0点-6点），若传感器探测到“有人”移动，但系统中无开台订单或门禁记录，应立即联动声光报警器并推送异常消息给管理员。

6. 总结

通过芯步开放的HTTP协议栈，将吸顶人体传感器集成到共享台球厅项目中，不仅能实现基础的人来灯亮、人走灯灭，更重要的是打通了硬件感知层与业务订单层的数据壁垒。

开发者无需关注复杂的物联网底层通信，只需关注HTTP接口的对接。这种 “硬件直连服务器” 的架构，使得系统响应速度极快（80-120ms），且支持私有化部署，保证了连锁台球厅数据的安全性和稳定性。实施该方案后，预计单店每年可节约电费数千元，同时大幅提升用户“科技感”的体验评分。