活动现场人体存在监测：怎么把吸顶式雷达存在感应器对接到自己的项目中_解决方案

CATALOG

芯步的吸顶雷达传感器通过标准HTTP接口上报“有人/无人”状态，你只需要配置一个接收服务器即可完成对接。以下是完整的接入方案。

本方案的目标是解决活动现场（如会议室、展厅、工位区）无法精准识别静态人体（如久坐不动、专注工作）的痛点。传统的红外传感器在人体静止时易产生误报，而芯步的吸顶式雷达存在传感器 (UNI-CGQ-RT-XD-L) 采用毫米波雷达技术，能够通过检测呼吸胸腔起伏等微动，精确判断人体存在。

系统架构分为四层：

在编写代码前，需要进行物理与平台的初始化配置：

硬件安装
- 将吸顶雷达传感器安装在活动现场的天花板，高度2.5-4米。
- 注意：安装时避开金属结构、通风管道正对出风口，并确保与WiFi信号强度良好。
设备入网
- 通过芯步官方App或平台控制台，将传感器配网至现场2.4G WiFi网络。
- 记录下设备的唯一标识符（Device ID），后续调用接口需要此ID。
配置数据上报地址（关键步骤）
- 为了让传感器将“有人/无人”数据发送到你的项目后台，需要在芯步控制台设置 “消息推送URL”。
- 将你的服务器公网接口地址填入，设备探测到状态变化时，会主动HTTP POST至此地址。

活动现场的状态变化不需要你反复“查询”，而是由传感器主动“告诉”你的服务器。

1. 消息推送格式当雷达探测到状态从“无人”变为“有人”，或“有人”变为“无人”时，芯步平台会向你配置的服务器地址发送如下格式的JSON数据：

2. 服务端处理逻辑 (伪代码示例)你需要在自己的项目中编写一个API接口来处理上述请求：

该雷达传感器自带一路AC交流电输出（继电器），可以直接控制灯光或插座。你可以通过芯步的开放接口远程手动控制这路输出。

1. 接口信息

URL: http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
方法: POST
核心参数:
- device: 你的传感器设备ID。
- order: {"power":1} (开启继电器，设备通电) 或 {"power":0} (关闭继电器)。

2. 签名机制 (Sign)芯步使用动态签名鉴权，你必须严格按照以下规则生成sign

注：芯步支持私有化部署和局域网纯环境运行，如果活动场地安全性要求比较高，可将整套系统部署在内网。

在将雷达传感器对接至项目时，需关注以下三个技术细节：

覆盖区域与灵敏度该雷达探测距离最远可达6米（运动），角度约120°。如果你的活动现场需要精准识别特定工位或展品，需调整安装位置；若仅需检测是否有人“存在”（例如卫生间、洽谈室），利用其检测呼吸的灵敏度即可，参数可调。
防误报与延时机制活动现场人员走动频繁，为避免灯光/插座频繁通断，在代码逻辑或平台配置中增加去抖动逻辑。
- 策略：当收到radar_target=0（无人）信号时，不立即断电，而是等待30-120秒。
- 若此期间再次收到radar_target=1，则取消断电；反之则执行断电。
设备状态同步 (心跳)若项目中有大屏需要实时显示设备“在线/离线”状态，请关注芯步推送的boot（设备上线）事件。如果设备离线，平台通常会有超时机制，你的前端页面配合WebSocket定时刷新设备状态列表，提升管理体验。