一、写在前面
大家好，今天我们来聊一个很接地气的话题：怎么把芯步的壁挂式双模人体活动监测器，集成到你自己的软件项目里。
如果你正在开发餐厅包厢管理系统，或者类似的无人值守空间解决方案，这篇文章应该能帮你省不少事儿。
先说说这个设备是啥。简单来讲，就是一个装在包厢墙上的小玩意儿，它能“感觉”到房间里有没有人。但它不是那种普通的感应灯——那种你坐着不动它就以为没人了，很尴尬。这个是红外+雷达双模的，红外负责“看到”人，雷达负责“感觉到”人，哪怕你只是在那儿坐着玩手机，它也知道你在。
二、为什么餐厅包厢需要这玩意儿？
聊技术之前，先说说痛点。
餐厅老板最怕什么？空转。包厢没人，空调开16度，灯光全亮，电视还播着世界杯重播——电费哗哗地流。更别提有的客人走了，服务员没及时关，能空烧一两个小时。
反过来，客人最烦什么？没人理。刚坐下想点菜，按了呼叫铃半天没人来；想加个菜，找不着服务员。
所以这套系统的核心价值就两点：
| 角色 | 痛点 | 解决方案 |
|---|---|---|
| 老板（管钱） | 空转费电、设备寿命损耗 | 无人自动断电 |
| 客人（要体验） | 服务响应慢 | 有人自动触发服务流程 |
| 店长（管效率） | 包厢状态不透明 | 实时掌握使用情况 |
一个传感器，两头都照顾到了。
三、设备长啥样？有啥硬指标？
先过一遍参数，心里有个数：
型号：UNI-CGQ-RT-H-BG
安装方式：壁挂，带万向支架，角度可调
供电：AC 100-250V 市电直供（不用换电池，省心）
检测原理：红外感应 + 雷达感应（双模）
检测范围：雷达可探测5米内人体微动
判断逻辑：红外和雷达都探测不到人，才判定为无人
输出：1路电源输出（可接照明、空调等，最大2200W阻性负载）
联网：WiFi 2.4GHz，直连路由器，不需要网关
接口：开放HTTP API，任何语言都能调
重点说一下那个“双模”判断逻辑：一般的红外感应器，人坐那儿不动它就以为没人了，然后“啪”把灯关了，很烦。但这个不会，因为雷达能检测到人体的微动——呼吸、心跳带来的细微动作，它都能捕捉到。只有红外和雷达同时说“没人”，它才真的判定为无人。这对于餐厅包厢特别友好，客人吃着吃着不会突然黑灯。
四、核心集成思路（整体架构）
在开始写代码之前，我们先理清楚整个系统的架构。说白了就是一句话：设备上报状态，你的系统接收处理，你的系统下发指令控制。
具体流程是这样的：
flowchart LR
subgraph A[硬件层]
S1[人体传感器
包厢1]
S2[人体传感器
包厢2]
end
subgraph B[云平台/服务器]
API[芯步云API
api.thingboot.com]
YOUR[你的业务服务器]
end
subgraph C[应用层]
APP[服务员APP/小程序]
DASH[管理后台大屏]
end
S1 -- HTTP上报 --> YOUR
S2 -- HTTP上报 --> YOUR
YOUR -- API调用 --> API
API -- 指令下发 --> S1
API -- 指令下发 --> S2
YOUR -.-> APP
YOUR -.-> DASH有两种集成模式
设备主动上报：当传感器检测到有人/无人时，主动往你的服务器发HTTP请求，告诉你“包厢3有人了”。这是最常用的方式。
你的系统主动查询/控制：你的服务器主动调用芯步的API，去查设备状态，或者下发指令（比如强制关灯）。
五、实操：两种集成方式
方式一：设备主动上报（推荐）
这是最省事的方式。设备检测到状态变化时，会主动往你指定的服务器地址发数据。
配置步骤
在芯步控制台，找到你的设备
设置“数据接收URL”，填上你的服务器地址，比如
https://你的域名/api/sensor/callback设备就会在