芯步的人体存在探测器采用双模检测技术（红外+雷达），能够可靠识别5米范围内的静态人体，避免“人还在、灯灭了”的尴尬。其开放接口采用标准HTTP协议，支持公网/局域网双模式，便于快速集成到现有系统中。
1 引言
在智能办公和家居场景中，传统红外传感器往往无法识别静坐、睡眠等静态人体，导致误判断电，用户体验不佳。芯步推出的5米人体存在探测器采用红外与雷达双模检测技术，解决了这一痛点。本方案的目标是指导开发者如何利用该产品的开放HTTP API接口，快速集成并实现人来灯亮、人走电断等多设备联动控制。
2 硬件特性
在开始对接前，开发者需要充分了解该探测器的核心技术参数和行为模式，这对后续的逻辑设计至关重要。
双模检测机制：该传感器内置红外感应模块和雷达感应模块。判定逻辑为“与”关系，即只有当红外和雷达同时检测不到任何微动或生命体时，系统才会判定为“无人”状态。这一机制有效避免了单雷达误触（如检测到窗帘晃动）或单红外无法识别静态人体的缺陷。
状态实时上报：设备支持WiFi 2.4G直连，无需网关。当人体存在状态发生变化时（由有人变为无人，或由无人变为有人），设备会主动向预设的服务器地址推送状态数据。
数据安全性：支持私有化部署和局域网通信。即使外网断开，只要手机和设备在同一局域网内，依然可以进行联动控制。
3 开放接口对接原理
芯步的开放平台基于HTTP协议，采用典型的请求-响应架构。整个联动分为上行数据（传感器上报）和下行指令（控制其他设备）两个部分。
3.1 设备接入流程
注册与创建应用：在芯步开放平台注册开发者账号，获取唯一的AppID和AppSecret。
设备配网：通过官方App将传感器配置到本地WiFi网络，并设置消息推送地址（即你的公网或内网服务器URL）。
获取设备ID：在控制台获取传感器的唯一标识Device ID，后续所有API调用均需此ID。
3.2 数据上报格式
当探测到人员状态变化时，传感器会向你的服务器发送如下格式的JSON数据：
你的服务器需要维护一个接收此数据的接口，这是整个联动控制的触发器。
3.3 设备控制指令格式
当你的服务器接收到传感器数据后，需要解析数据并决定是否触发其他设备（如灯光、插座、喇叭）。调用控制接口的指令示例如下
请求地址
https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方式：POST
请求体示例（控制插座通电）
签名机制：为保证接口安全，每次请求需携带签名。签名计算方式为：sign = md5(md5(AppSecret) + ts)（其中ts为Unix时间戳）。
4 联动控制逻辑实现方案
为了实现可靠的多设备联动，架构上采用云端/本地服务器作为中枢，而非点对点直连。这样不仅能解耦设备，还能方便地配置复杂的延时和场景逻辑。
4.1 基础联动（人来灯亮/人走灯灭）
触发：员工进入办公室，传感器雷达与红外同时探测到人体。
上报：传感器通过HTTP POST将“有人”状态推送到你的业务服务器。
决策：服务器收到状态后，查询当前关联的场景规则。若此时光照传感器（另购）数据低于阈值或处于工作时间段。
执行：服务器向芯步API发起控制请求，指令下发至智能开关/插座，灯光亮起、空调开启。
延迟关闭：当人员离开，传感器上报“无人”状态。服务器可设置30秒延时（防止误判），延时结束后下发“关闭”指令。
4.2 高级场景：会议室预定与节能联动
利用5米探测范围，可以覆盖小型会议室的全部区域。实现逻辑如下：
状态同步：当传感器持续上报“有人”超过5分钟，服务器自动将该会议室在OA系统中的状态标记为“占用中”，禁止其他人通过小程序预定该时段。
空闲释放：若传感器上报“无人”且持续时间超过15分钟，服务器不仅切断电源，还需调用OA接口自动释放该会议室资源，结束计费或流转状态。
4.3 异常处理机制
由于雷达和红外双模的存在，极少出现完全误判。但在调试初期，配置Webhook日志服务。如果出现“无人”状态下设备自动断电，检查服务器是否收到了none信号，以及是否存在多台设备ID混淆的情况。
5 典型联动配置清单
以下是一个标准的智能办公隔断间联动方案，可供开发者参考配置：
| 触发条件 | 执行动作 | 注意事项 |
|---|---|---|
| 状态：有人 | 1. 智能插座（电源）通电2. 步进式电动窗帘执行开启3. 语音播报器：“欢迎光临，设备已就绪” | 延时等待：若联动设备较多，指令下发间隔500ms，避免网络拥堵 |
| 状态：无人持续60秒 | 1. 空调/风扇关闭2. 照明灯光熄灭3. 空气净化器待机 | 防误判：60秒延时至关重要，避免用户短时离开取快递导致频繁开关机损耗设备 |
| 状态：无人持续>15分钟 | 1. 切断总电源插座2. 进入深度节能模式 | 二次确认：可在断电前通过语音喇叭播报倒计时，允许用户通过遥控器打断关机流程 |
6 总结
通过对接芯步5米人体存在探测器的开放接口，开发者可以构建出具备高感知精度和强逻辑性的智能空间管理系统。其核心优势在于双模检测杜绝了静态误判，而标准的HTTP API极大地降低了服务器对接门槛，无论是对接芯步生态内的语音喇叭，还是自有OA系统，均能实现毫秒级响应。实施本方案后，预期可实现办公区域30%以上的综合节能效果。