无人值守空间人体存在检测：怎样把雷达人体存在探测器集成到自己的项目中_解决方案

CATALOG

无人值守空间的痛点在于：传统红外传感器无法检测静止人体（如睡着、专注办公），导致误判“无人”而错误关灯或关空调。毫米波雷达技术通过捕捉呼吸引起的胸腔微动，彻底解决了这一问题。芯步的产品将这一复杂算法封装成了标准化的HTTP API，使得开发者无需处理雷达信号、点云数据等底层技术，只需调用接口即可获得“有人/无人”的结论性结果。

以下方案将分四个部分详细拆解集成过程。

一、方案架构

要将雷达探测器集成到你的项目中，通常需要遵循以下软硬结合的架构。整个数据流向是闭环的，既包括了“感知”上行，也包括了“控制”下行。

数据流转路径：

感知层： 安装在现场的芯步雷达传感器（如吸顶式或壁挂式）发射毫米波，探测人体微动。
网络层： 设备通过WiFi 2.4G直接连接路由器。注意： 芯步的设备不需要单独的网关，这是它降低集成难度的优势之一。
云平台层： 传感器将“有人/无人”状态通过HTTP协议推送到你指定的服务器（公网或私有化部署的服务器）。
应用层： 你的业务系统接收数据，根据逻辑判断，通过API下发指令给执行设备（如灯光、空调），或存入数据库用于展示。

二、核心集成步骤（开发者视角）

集成过程不需要复杂的嵌入式开发，主要是进行服务端API对接。你需要完成以下几个技术动作：

1. 环境准备与凭证获取

首先，在芯步官网注册开发者账号并创建“工作台”。

获取关键凭证： 在控制台的“开发设置”中，你会获得 AppId（应用ID）和 AppSecret（应用密钥）。注意：AppSecret 是用于签名的重要凭证，必须严格保密，严禁在前端代码中暴露。

2. 设备配网与激活

将雷达传感器通电。

配网方式： 由于无需网关，传感器通常通过AP热点模式或蓝牙进行配网。你需要通过芯步提供的配网工具，将你的WiFi账号密码告诉传感器。
获取Device ID： 配网成功后，设备会在控制台上线，并生成唯一的 Device Id（设备编号）。这是你后续精准控制该设备的ID。

3. 必须掌握的两类API调用

要完成“无人值守”逻辑，你需要实现两个方向的接口调用：

A. 接收设备数据（消息推送）雷达传感器是“主动说话”的设备。当检测到人体状态变化（比如从无人变为有人，或从有人变为无人），它会主动向你的服务器发送数据。

你需要做的： 在你的服务器上准备一个公网可访问的URL（例如：https://yourdomain.com/api/yoyo_callback），并在芯步控制台配置这个地址为“消息推送”地址。
数据格式示例：当传感器检测到有人时，你的服务器将收到类似如下的POST数据：
{ "device_id": "820720"， "msg_type": "telemetry"， "data": { "radar": { "presence": "true"， // true=有人， false=无人 "illuminance": 320 // 部分型号也带光照强度 } }, "time": 1702886400 }

B. 向设备下发命令（设备控制）当无人状态持续一段时间后，你需要通过API去关灯或断电。

请求方式： HTTP POST
请求地址结构：http（s）：//api.thingboot.com/ {AppId} /device/control/？sign= {签名} &ts= {时间戳}
签名算法（关键安全步骤）： 为了防止接口被恶意调用，请求必须携带签名。
1. 将你的 AppSecret 进行一次MD5加密；
2. 将加密结果拼接上当前的时间戳 ts；
3. 对这个新的字符串再次进行MD5加密，得到 sign。
4. *(公式：sign = md5（md5（AppSecret） + ts）)*
请求体示例（关闭雷达电源或线路）：
{ "device": "820720"， // 目标设备ID "order": {"power": 0} // 0表示关闭线路，1表示开启 }
部分传感器还支持调整灵敏度（sensitivity）或雷达开关（radar_enable）。

三、业务逻辑设计与优化（场景）

仅仅能收发指令是不够的，为了避免误判，在你的业务代码中加入以下防抖与逻辑优化逻辑：

无人延时确认机制（Debounce）：
- 场景： 人可能在座位上睡着了，呼吸极其轻微，或者只是在椅子上转身背对传感器。
- 方案： 设定一个计时器。当收到“无人”信号时，不要立即关灯。等待30秒（可配置）。如果在这30秒内连续收到3次“无人”信号，再执行关灯操作。
- 代码逻辑伪代码：if（radar_status == “absent”） { startTimer（30s）； if（timer > 30s && status_again == “absent”） { turnOffLight（）； } }
多设备联动（Zone Control）：
- 场景： 一个会议室很大，装了两个雷达。
- 方案： 在服务器端编写联动规则。只有当两个雷达都上报“无人”时，整个会议室的设备才断电。
光照强度辅助（节能优化）：
- 场景： 白天窗户边有人，光线充足，不需要开灯。
- 方案： 如果你的雷达型号包含光照传感器，可以设置逻辑：IF 有人 AND 光照 < 200 lux THEN 开灯 ELSE IF 无人 THEN 关灯。

四、安装和需要注意的点（实操避坑）

软件写得好，硬件装不对，效果也出不来。雷达传感器虽然穿透塑料外壳能力强，但对金属和遮挡极为敏感。

安装位置：
- 吸顶安装： 适合办公室、会议室。安装高度通常在2.5米-4米之间，探测范围呈一个伞形区域。
- 避免直吹： 虽然雷达比红外抗干扰强，但强烈的空气流动（如空调出风口直接对着吹）或大范围运动的机械（如风扇、窗帘）依然可能产生轻微误报。安装时尽量避开这些干扰源。
材质穿透：
- 好消息： 雷达波可以穿透塑料、亚克力、木板。你可以把传感器隐藏在吊顶内或木制装饰品后面，保持美观。
- 坏消息： 金属会屏蔽雷达波。传感器背后如果有金属底盒，信号会变差。玻璃会衰减信号，尽量避免隔着玻璃检测。