餐厅包厢人体感应控制：怎样将智能人体存在传感器吸顶红外版接入到软件项目中_解决方案

CATALOG

芯步的这款吸顶红外传感器通过HTTP接口直接上报数据，无需网关，接入成本较低。以下方案涵盖设备配网、数据接收、指令下发到业务落地的完整链路，你可根据实际编程语言调整签名和接口调用方式。

1. 背景与需求分析

在高端餐厅或私房菜馆的包厢管理中，能源浪费和硬件损坏是常见痛点。服务员频繁进出查看空包厢不仅增加人力成本，也打扰了用餐顾客。同时，卫生间或备餐间常因“安静状态”（如顾客长时间如厕或员工备料静止）导致灯光误灭，造成不佳体验。

本方案的目标是利用 “智能人体存在传感器[吸顶][红外版]”（型号：UNI-CGQ-RT-XD-H） 的开放API能力，将其无缝集成到现有的餐厅SaaS系统或小程序中，实现基于人体存在状态的自动化闭环控制。

2. 硬件特性与选型

在选择该传感器时，需关注其对餐厅场景的适配性：

供电与负载能力：该设备采用 AC 100-250V 强电供电，可直接替代原有的墙壁开关或接入吊顶灯路。其内置继电器支持 2200W阻性负载，可直接控制包厢主灯，无需额外继电器。
探测机制：采用红外技术，对温度变化敏感。需注意避开空调出风口（冷风干扰）或密封极好的保温材料。
通信协议：支持 WiFi 2.4GHz 与 HTTP接口，这意味着它不需要购买额外的网关（LoRa网关等），可直接利用餐厅现有的无线网络接入云端或本地服务器。

3. 软件接入设计

为了实现自主控制，我们采用“设备直连私有云”的架构，避免数据经过芯步公有云产生的延迟（尽管其公有云永久免费，但局域网控制更稳定）。

通信流程
1. 传感器探测到人体状态变化（无人 $\rightarrow$ 有人 / 有人 $\rightarrow$ 无人）。
2. 传感器通过 WiFi 将 HTTP POST 请求发送至 餐厅本地服务器 或 公有云服务器 的指定接口。
3. 后端逻辑判断：如果是“有人”，直接不做处理（灯本来可能就亮着）或联动欢迎语；如果是“无人”，启动“延迟倒计时”（如30秒）。
4. 关键下发：计时结束后，后端通过调用芯步的 HTTP 远程控制接口，向传感器发送断开继电器的指令（关灯）。

交互环节	触发端	动作描述	通信方式
状态上报	传感器	探测到人/无人时主动上报数据	HTTP POST (上报)
逻辑处理	业务服务器	解析数据，判断包厢状态，执行联动	内部逻辑
指令下发	业务服务器	控制继电器接通/断开（开关灯）	HTTP POST (控制)
远程维护	管理员/App	状态查询、固件升级、参数调整	HTTP POST (控制)

4. 关键接入步骤详解

4.1 设备配网与注册

由于该设备没有复杂的屏幕，接入软件前需先将其连上网络并获取唯一标识。

通电与配网：使用“芯步”官方小程序或物联网控制台，对设备进行 SoftAP 或 SmartConfig 配网，使其连接到餐厅的 2.4G WiFi。
获取设备ID：在物联网控制台的后台获取该传感器的 Device ID（设备唯一标识）。这一步至关重要，后续所有API调用都需要此ID作为身份标识。

4.2 数据上报接口对接（接收传感器消息）

设备探测到状态变化时，会向预设的 URL 发送数据。你需要在你的服务器端实现一个公网可访问或局域网可访问的 POST 接口。

接口配置（在芯步后台设置）：

上报地址https://your-domain.com/api/sensor/callback
消息示例（根据通用物模型推测）：
{ "device_id": "CGQ_TEST_001", "timestamp": 1699234567, "data": { "presence_status": 1, // 1: 有人, 0: 无人 "illuminance": 320 // 可选，部分版本支持光照度 } }

服务器处理逻辑（伪代码）：

4.3 设备控制接口对接（下发命令）

当服务器决定关灯或开灯时，需要主动调用芯步的 Open API 向设备发送指令。

调用方式芯步接口采用 HTTP GET 或 POST 方式，签名算法为 md5(md5(AppSecret) + ts)。

请求示例（关闭所接的照明灯）：

URLhttps://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}
Body (JSON)
{ "device": "CGQ_TEST_001", // 你的传感器设备ID "order": {"infrared_enable": 0} // 假设 0 表示断开输出，或使用通用的电源控制指令 }

注：具体的“断开电源”命令字段需参考该传感器的详细指令表，通常涉及对内部继电器的控制。

5. 业务难点攻关：餐厅“安静就餐”场景优化

标准的红外传感器在包厢场景有个致命弱点：顾客安静坐着玩手机或吃牛排时，身体微动不足以触发红外变化，系统会判定为“无人”，导致“人在灯灭”。

解决方案策略：

延长“无人确认”时间窗口不要收到“无人”信号就立刻关灯。在代码逻辑中，设定一个 30-60秒的缓冲期。只有当传感器连续上报“无人”状态超过60秒时，才执行关灯动作。
结合继电器状态逻辑允许服务员或顾客通过原有物理开关进行干预。如果服务器检测到物理开关被强制打开，则暂时挂起自动关灯程序30分钟。
利用接口查询状态如果餐厅系统与点餐Pad打通，服务生撤场前可在Pad上点击“清扫模式”，调用API强制将传感器阈值调至最灵敏或直接锁定继电器为接通状态，此时不受人体红外探测影响。

6. 系统集成与联调

私有化部署选项：芯步支持私有化部署。如果餐厅对数据安全要求比较高（如米其林餐厅的定制化数据），可以将整个接口系统部署在餐厅的本地服务器上，即使在断外网的情况下，传感器依然能通过局域网控制灯光。
与现有餐饮软件集成
- 预定系统：当收银系统在预定时间前30分钟将包厢状态改为“已预定”时，自动调用接口开启传感器工作。
- KTV/音乐系统：探测到有人进入时，除了开灯，还可以通过 HTTP 接口向智能背景音乐系统发送指令，播放欢迎词或轻音乐。

7. 效益分析

通过对接芯步该款传感器，一个拥有10个包厢的餐厅可实现的效益如下：

节能：解决空调/灯光空转问题，预计电费节省 20%-30%。
提升翻台率：服务员不再需要频繁推门查看包厢是否离开现场时，系统自动推送“包厢已无人，请保洁”的通知至工作手机，加速清洁和翻台流程。
体验升级：实现“客人步入即亮，离开延灭”的无感智能化体验。

8. 总结

将芯步吸顶红外传感器接入软件项目是一项典型的物联网云集成任务。开发者只需关注 数据回调的接收处理 和 API鉴权调用 两个核心环节。针对餐厅包厢的特殊性，通过后端逻辑上的 延迟判断策略 有效规避了红外传感器对静态人体的漏判问题，即可快速、稳定地实现餐厅包厢的智能化节能改造。