共享棋牌室的痛点是“长租场景下的无效供电”——顾客离开时忘关灯、商家无法远程干预、空调麻将机白白运转。这篇方案会讲清楚如何利用芯步的红外传感器和开放接口，把传统灯控改造成按需照明、可远程管控的智能系统。
1. 背景与需求分析
在共享棋牌室（无人值守自助棋牌室）的运营场景中，照明、空调、麻将机等设备的能耗是主要运营成本之一。常见的痛点是：顾客离开时忘记关灯关空调，导致长达数小时甚至整夜的无效供电，造成严重电能浪费。此外，由于无人值守，商家无法远程干预，管理效率低下。
为了解决这一问题，本方案的目标是通过集成芯步智能硬件产品中的红外人体存在探测器，实现“人来灯亮、人走灯灭”的自动化控制，并将设备状态同步至后台管理系统。这不仅能显著节省电费，还能提升棋牌室的智能化管理水平。
2. 系统设计
本方案采用“端-云-管-用”的四层架构，将硬件感知层与企业现有的软件业务系统紧密结合，主要组件说明如下：
2.1 硬件感知层
包括安装在每个包间顶部的智能人体存在传感器[吸顶]。该传感器利用热释电效应或雷达技术探测人体辐射的红外线或微动，判断房间内是否有人。它不仅检测移动，高端型号还可检测微动（如静坐），避免打麻将过程中因动作小导致灯误灭。
2.2 数据传输层
芯步的设备支持 HTTP 和 MQTT 协议。当传感器状态变化（从“无人”变为“有人”），设备会主动向配置好的服务器地址推送状态数据。商家服务器也可通过HTTP接口主动查询设备状态或下发指令。
2.3 云平台与业务层
芯步开放平台：负责设备管理、数据转发和鉴权，将设备上报的数据转换为标准JSON格式，通过API推送给商家的业务服务器。
业务服务器：接收传感器数据，执行核心逻辑（防抖、计时、联动）。
控制执行端：向灯具、插座（控制麻将机电源）下发开关命令。
2.4 系统流程图解
检测阶段：红外传感器监测到人体存在（输出高电平）。
上报阶段：传感器通过WiFi将“Occupancy: True”状态推送到商家云服务器。
决策阶段：服务器判断光线阈值，确认需开灯。
控制阶段：服务器调用芯步开放API，向智能插座/开关下发“Power: ON”指令。
延时阶段：当传感器上报“无人”状态后，服务器启动3-5分钟计时器，防止短暂离开误关灯。
关闭阶段：计时结束，向插座下发“关”指令。
3. 硬件选型：红外与雷达的抉择
在共享棋牌室场景中，传感器选型直接影响用户体验。芯步旗下有多种存在传感器，根据实际情况对比选择：
3.1 红外人体传感器（PIR）
原理：检测人体发出的红外线变化。
优点：功耗极低、成本较低，对大幅度移动极其敏感。
缺点：容易受温度影响，对静止不动的人体（如低头看手机）容易误判为“无人”，导致灯光熄灭，影响体验。
适用场景：卫生间、走廊等短暂停留区域。
3.2 毫米波雷达/高端存在传感器
原理：发射电磁波并接收回波，检测呼吸带来的胸腔起伏。
优点可感知静态人体，不受温度影响，精度高。
缺点：价格较贵、部分型号可穿透石膏板可能造成隔墙误判。
适用场景：麻将房核心区域。采用此方案，确保麻将过程中灯光始终常亮，不熄灭。
4. 软件集成核心步骤
要将芯步的红外探测器集成到现有的棋牌室管理软件项目中，需按以下步骤对接：
4.1 设备注册与API凭证获取
在芯步开放平台创建开发者账号，获取
AppId和AppSecret。将购买的传感器设备添加至平台，获取唯一
device_id。在平台配置“消息推送地址”——填写业务服务器的公网回调接口（如
https://api.your-ktv.com/yoyo/callback）。
4.2 接收设备上报数据
芯步设备支持主动HTTP推送。当检测到人员变化时，服务器将收到如下格式的POST数据包：
代码处理逻辑 ：服务器需维护房间状态。由于网络波动可能重复推送，需记录上一次状态，仅在状态变化时（由true变false或反之）触发业务逻辑，避免重复调用。
4.3 业务逻辑实现
业务逻辑是防止误判的关键，主要处理“无人上报后的延迟”与“防抖过滤”。具体规则如下 ：
规则一：防抖过滤
场景：风帘、空调冷风导致红外传感器出现误触发。
策略：若1秒内连续收到超过3次“有人/无人”切换，服务器应进行熔断，忽略后续请求，维持当前设备状态。
规则二：延迟关灯（离店延时）
场景：顾客上厕所或短暂出门抽烟。
策略：传感器瞬间上报“无人” -> 服务器不立即关灯，创建计时器 -> 计时5分钟 -> 5分钟内若收到“有人”，取消计时器，保持照明；5分钟后若仍为无人，执行关灯。
4.4 下发控制指令
当服务器逻辑判定需开/关灯时，反向调用芯步的 设备控制接口 控制智能插座：
请求地址
https://api.thingboot.com/ordercontrol请求方法
POST请求头
Authorization： Bearer请求体
通过此指令，可开启或关闭麻将桌上的总电源插座，实现对麻将机和照明的通断控制。
5. 与共享棋牌室业务系统的深度集成
纯自动控制比较简单，但结合“共享”属性，需与订单系统联动：
5.1 订单状态联动逻辑
自动照明与取电需严格绑定订单状态，具体判断条件如下：
| 房间状态 | 传感器逻辑 | 取电/照明策略 |
|---|---|---|
| 空闲（未售） | 忽略传感器数据 | 软件层拒绝执行“开灯”指令。即使传感器检测到有人（如保洁进入），灯也不亮或需管理员密码/扫码亮灯。 |
| 已售（计时中） | 有人 | 自动开灯、开空调、麻将机通电。 |
| 已售（短暂无人） | 无人 -> 5分钟倒计时 | 仅关闭灯光，保留插座和空调电源（保持低温或麻将机待机），便于顾客返回立即进入舒适状态。 |
| 超时未续费 | 有人 | 软件不下发关灯指令，而是下发灯光闪烁指令（通过频繁开关或调节色温）提醒顾客，同时通知后台客服介入。 |
5.2 远程运维支持
商家运营端可提供手动接管功能——当顾客反馈“人没走灯灭了”时，运营人员可在管理后台（Web/小程序）点击“重置设备”或“强制上电”，远程强制开启照明，降低客诉。
6. 接口协议深度解析
芯步的开放接口设计简洁，主要参考点如下：
协议类型：支持HTTP/HTTPS与MQTT。对于灯控这种实时性要求高的场景，MQTT长连接在并发控制上表现更优，能实现80-120ms的低延迟响应。
设备影子：云端维护设备影子，即设备上报“占用”后服务器返回
reported属性更新，由于关灯逻辑在服务端实现，设备影子的desired状态应与reported一致，便于同步设备端与云端属性。签名机制：调用API时需携带
sign签名和时间戳ts，防止重放攻击。例如计算/open/api？sign=xxxx&ts=1625234567时，按字典序排序参数并进行MD5加密。
7. 故障排查与维护
在实际部署中，常遇到的问题及解决方案如下：
传感器频繁误报：检查安装位置是否正对空调出风口或散热区域。热风或冷气的剧烈流动会触发PIR传感器误判，应调整探测角度避开风口。若仍存在误报，可在业务代码中检查上报频率，丢弃过于密集的无效报文。
Bug：人未走灯灭了：若使用普通红外传感器（PIR），打麻将时人体动作幅度小且环境温度接近体温，传感器可能检测不到红外辐射变化，从而误判为无人。解决方案：更换为芯步的毫米波雷达存在传感器系列，此类传感器可通过检测呼吸引起的微弱位移判断静态人体存在，确保“人在灯常亮”。
网络延迟导致指令未执行：确认设备网络的2.4G信号强度。芯步设备支持断网重连与离线缓存。若业务对稳定性要求比较高，可启用芯步支持的自建MQTT服务器（私有化部署），在纯局域网环境下运行，消除公网抖动影响。
8. 总结
通过集成芯步的红外人体存在探测器及其开放API，共享棋牌室可升级为完全自动化的节能空间。本方案的关键点在于：硬件层面尽量选择可探测静态人体的高端传感器（如雷达存在传感器）以避免麻将过程中熄灯；软件层面必须结合订单系统设计延时关灯逻辑，以平衡节能与顾客体验。芯步标准的HTTP/MQTT接口极大降低了开发门槛，使开发者能快速将传统照明设备纳入SaaS系统统一管理，最终实现降本增效。