共享棋牌室的无人化管理中，照明控制的痛点在于“精准判断无人”——纯红外传感器在人体静坐时容易误判关灯。以下方案基于芯步的壁挂式红外雷达复合探测器，利用其双模检测和HTTP接口，实现可靠的自助照明控制。
1. 背景与选型分析
在共享棋牌室（也称无人棋牌室、24h自助棋牌室）的运营中，电费控制是运营成本的重要组成部分。传统的人工管理或简单的声光控开关，往往无法精准识别“麻将桌上有人静坐思考”与“客人临时离席上厕所”之间的状态差异，导致照明常亮或误关。
为了解决“静坐不动”与“无人关灯”之间的矛盾，本方案推荐采用芯步智能人体存在传感器[壁挂]（型号：UNI-CGQ-RT-H-BG）。该设备的核心优势在于：
双模检测：融合红外与雷达毫米波技术。红外负责捕捉大范围移动，雷达负责探测微动（如呼吸起伏、手指移动）。只有当两者均判定无人时，才执行关灯动作，彻底解决“人静坐，灯误灭”的痛点。
强电直控：设备自带AC 100-250V继电器输出，可直接串联在照明回路中。这意味着它既是一个传感器，也是一个执行器，无需额外购置智能开关。
开放接口：支持HTTP API控制和实时状态上报，可无缝对接自有的SaaS后台或小程序。
2. 硬件设备选型与架构
| 设备名称 | 推荐型号/关键参数 | 作用 |
|---|---|---|
| 核心设备 | 芯步 UNI-CGQ-RT-H-BG | 探测人体存在；直接控制220V照明通断；通过WiFi上报状态 |
| 网络环境 | 2.4GHz WiFi | 设备入网与通信 |
| 服务器 | 公有云/私有化服务器 | 接收设备上报的“有人/无人”事件，记录日志，实现逻辑联动 |
| 照明负载 | LED灯/节能灯 | 受传感器直接控制。注意LED灯属于感性负载，需核对负载功率 |
拓扑结构传感器（接入220V市电+串联灯具） <---> 本地WiFi路由器 <---> 芯步云（或直连自建服务器） <---> 自建SaaS后台 <---> 商家端/用户端小程序。
3. 接入开发核心流程
要将该传感器接入到自己的“共享棋牌室管理系统”中，主要分为物理接线、网络配置、HTTP接口对接三个步骤。
3.1 物理安装与“零代码”控制（最简模式）
首先，由于该设备内置继电器，最简单的接入方式是不写一行代码，利用其物理特性：
接线：将市电火零线接入传感器的输入端，将灯具的火零线接在传感器的输出端。
效果：设备上电后，自带逻辑默认为“有人开灯，无人关灯”（延时可调）。
优点：物理层面保障了基础照明功能，即使服务器宕机，包间灯依然会随人而动。
局限：无法向后台精准上报“第几号包间在几点几分有人开始使用”，无法与订单系统挂钩。
3.2 开放接口对接（智能化模式）
为了实现“订单开始自动通电、结束后强制断电、离席节能”等高级逻辑，需要调用芯步的开放平台API。
第一步：设备入网与注册
通过芯步提供的配网工具（或自研配网小程序），将传感器连接到棋牌室的2.4G WiFi。
获取设备的唯一标识符（Device ID），并在你的后台系统中将该ID与“包间号”绑定。
第二步：接收设备状态上报传感器检测到有人或无人时，会主动向预设的服务器地址推送数据。你需要在系统中实现一个接收端点。
数据流向：传感器 -> 物联网云 -> 你的服务器（HTTP POST）
处理逻辑
收到
{ "status": "someone", "radar": "detected", "infrared": "detected" }：更新该包间状态为“占用中”。收到
{ "status": "no_one", "radar": "none", "infrared": "none" }：此时如果订单已结束，可执行断电。
第三步：远程干预与控制（场景联动）当用户在小程序下单时，你需要通过HTTP接口控制传感器，确保照明开启。
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/请求方法：POST
请求示例（开启照明）：
应用场景：用户下单成功 -> 系统调用该接口 -> 传感器继电器吸合 -> 灯亮。同时响应传感器的状态上报，形成闭环。
4. 业务逻辑设计（Scene）
结合共享棋牌室的具体业务，在自研系统中实现以下自动化逻辑，以提升体验并省电：
4.1 “订单绑定”模式
逻辑：只有用户付费下单后，传感器才生效。
流程：用户在App/小程序购买2小时 -> 后台向指定包间的传感器下发
power:1-> 传感器开始探测。优势：防止非客户占用包间。若未下单有人进入，后台可触发告警。
4.2 “离席延时与微动侦测”精细化控制
逻辑：当客户短暂离席（如去前台买水、上洗手间）时，灯不灭。
技术实现：传感器内置逻辑（通常为30秒-2分钟延时）。当红外信号消失，但雷达仍能探测到微弱移动（如空调风吹动沙发）或完全无移动时，才开始计时。
配置项：利用
radar_enable和infrared_enable命令调节灵敏度。
4.3 结束后的强切保护
逻辑：订单时间结束（且未续费）-> 即使传感器探测到有人，系统强制下发
power:0指令。注意：这需要后台逻辑覆盖传感器的本地逻辑。这是为了防止客户超时不付费赖着不走。
5. 总结
利用芯步的 UNI-CGQ-RT-H-BG 壁挂式传感器，开发者可以零代码实现基础的照明自动化（利用内置继电器），也可以通过标准的HTTP API实现深度的商业逻辑定制。
该项目落地的关键在于理解“双模检测”的价值：解决了传统红外传感器在顾客静坐打牌时识别不到人的痛点。结合其开放的API接口，开发者可以快速地将“物理传感”与“商业订单”结合起来，构建出真正省心、省电的无人棋牌室系统。