芯步的壁挂式人体存在传感器采用HTTP主动上报机制——设备探测到状态变化时直接向你的服务器推送数据，而非被动轮询。这种“反控”模式更贴合酒店客房的实际管理需求。以下是完整的对接方案。

解决方案：基于芯步开放接口的酒店客房人体存在传感器对接方案

1. 背景与选型分析

在酒店智能化改造中，传统红外传感器无法检测静坐或睡着的客人，容易导致误判断电。芯步的壁挂式人体存在传感器（如UNI-CGQ-RT-H-BG）结合了红外与毫米波雷达技术，能感知呼吸级别的微动，是酒店客房场景的理想选择。

核心优势：

• 双模检测： 雷达（微动）+ 红外（体温移动），只有当两者均判定无人时才上报“无人”状态，彻底解决了卫生间晕倒等场景的误报问题。

• 直连架构： 设备通过 WiFi 2.4G 直连云端或局域网服务器，无需额外购买网关，降低了硬件成本。

• 接口开放： 支持HTTP/HTTPS协议，数据直接推送到你指定的服务器地址，兼容公有云、私有化部署甚至纯局域网环境。

2. 对接设计

整个对接流程采用 “设备主动上报 + 后端服务订阅 + 前端联动控制” 的架构：

1. 感知层： 安装在客房卫生间、卧室顶部的壁挂传感器，实时探测人体状态。

2. 传输层： 设备通过酒店客房内的WiFi网络，将数据以JSON格式POST到你配置的服务器接口。

3. 平台层（你的项目）： 你的服务器接收数据并更新设备状态，同时根据业务逻辑（如“无人持续30分钟”）向PMS系统或设备控制中心下发指令。

4. 执行层： AC继电器控制取断电，或通过API控制语音设备播报提醒。

3. 详细对接步骤

第一步：HTTP接口配置（设备数据往哪发）

在芯步的物联网控制台中，你需要将设备配置为“私有部署模式”，配置你的服务器接收地址。

• 配置项： 设备的“消息推送URL”。

• 格式：http(s)://[你的服务器公网IP或域名]:[端口]/api/yoyo/callback

• 说明： 设备在探测到状态变化时（如从“有人”变为“无人”），会立即向此地址发送请求。在内网部署时使用HTTP以降低延迟，公网部署必须使用HTTPS。

第二步：解析设备上报的数据（数据长什么样）

当有人进入房间，传感器会向你的服务器发送如下格式的JSON数据。你的后端代码需要解析这个数据结构。

核心数据字段解析：传感器上报的数据通常包含设备ID和当前状态，你需要解析以下关键字段：

• device / device_id： 唯一标识哪个客房哪个传感器触发了事件。

• status / presence： 业务字段，如 1 表示有人/存在，0 表示无人/离开。

• radar / infrared： 部分双模设备会上报两个独立通道的数据，供高级逻辑判断。

• timestamp： 事件发生的时间戳。

代码层面处理：你需要在项目中编写一个Webhook接收端（示例逻辑）：

1. 接收请求： 监听你配置的URL（如 /api/yoyo/callback）。

2. 验签（可选）： 生产环境下验证请求头中的签名，防止伪造数据攻击。

3. 入库/更新： 根据 device 找到对应的酒店客房号，更新内存或数据库中的“有人/无人”状态及最后更新时间。

4. 触发联动： 返回 HTTP 200 OK 给传感器以确认收到。

常见联动场景代码逻辑示例：

• 第一种场景：实时节能。 如果接收到 presence=0 (无人)，且该房间当前空调/电视处于开启状态 -> 调用芯步的设备控制接口或第三方强电面板接口 -> 发送关闭指令。

• 第二种场景：退房提醒。 如果保洁系统显示“待打扫”，而传感器状态变为 presence=0 -> 触发消息通知保洁员“房间已无人，可进行打扫”。

第三步：反向控制与联动（感知后的动作）

除了接收数据，你的系统还可以主动查询或控制传感器状态。

• 接口地址：http(s)://api.thingboot.com/{AppId}/device/control/

• 请求方法： POST

• 请求示例：

应用场景： 客人办理入住时，你的PMS系统触发接口，主动打开对应客房传感器的探测功能；客人退房后，远程关闭或重置设备。

4. 技术要点与难点解决

1. “有人”与“无人”的延迟策略（防误判）：

   • 问题： 雷达能探测微动，但如果客人躺在床上长时间玩手机不动，雷达可能因检测不到明显位移而判断为“微动微弱”。

   • 方案： 在代码逻辑中增加计时器。不要立即执行“无人断电”操作。当收到“无人”信号后，开启一个 15-30分钟 的倒计时。期间若再次收到“有人”，则取消倒计时。这结合了雷达的精准性和业务容错性。

2. 网络依赖与离线处理：

   • 问题： 纯WiFi设备对网络稳定性有一定依赖。

   • 方案： 利用设备自带的 AC 100-250V 电源输出接口。你可以直接将客房内的照明或插座线路串联进传感器。在传感器断网的情况下，其本地硬件逻辑（有人开/无人关）依然生效，作为兜底方案。

3. 隐私保护设计：

   • 亮点： 相比摄像头，雷达和红外无法采集图像信息。在你的项目文档或用户须知中，可以重点强调本方案采用的 “非接触式、非视觉成像” 技术，消除住客隐私顾虑。

5. 项目落地实施检查清单

在将传感器对接到你的最终项目时，按以下步骤进行验证，以确保交付稳定：

1. 网络连通性测试： 在酒店客房现场，确保传感器信号的强度达标。

2. API连通性测试： 使用 Postman 或 curl 命令，模拟芯步的推送格式，发送假数据到你的本地服务器，验证接口是否能正确接收并解析。

3. 灵敏度场景调试：

   • 测试人员进入房间 -> 观察服务器是否收到“有人”状态。

   • 测试人员卧床静坐/睡眠 -> 观察是否会被误判为“无人”。

   • 测试人员离开房间 -> 观察延迟多久后上报“无人”。

4. 联动闭环测试： 测试“无人”信号触发后，客房空调/插座是否实际断电。

通过以上方案，你可以将芯步的硬件能力无缝集成到现有的酒店管理或智能家居项目中，实现高可靠性的节能与安防管理。