共享棋牌室的“人走断电”看起来简单，但实际落地最大的坑在于：怎么判断“没人了”以及“真的没人了”。传统的红外感应一遇到人坐着不动打麻将，很容易误判断电。下面结合芯步的开放接口，讲一下怎么把吸顶式人体感应开关可靠地集成进去。

一、 分析：为什么普通的感应开关不行？

在做共享棋牌室项目时，我们通常面临两个核心难点：

1. 静止人体检测：麻友一旦坐下来打牌，活动幅度非常小。普通的红外感应头（PIR）只能感知移动的物体，如果人静止不动，它可能会判断“无人”，导致中途断电，这是运营大忌。

2. 远程复位与控制：当订单结束后，即使房间里没人了，如果系统不能自动复位，下一组客人进来可能没电，或者需要管理员手动去按开关。

针对这两个痛点，芯步生态中的吸顶式人体存在传感器（注意，一定要是“存在”传感器，最好是毫米波雷达或者红外+雷达“双模”，而不是单纯的“移动”传感器）是解决这个问题的关键硬件。

二、 整体设计

我们要把“传统单机版”的感应开关，变成“云端联动”的逻辑。

物理连接拓扑：

吸顶传感器（检测人） ---> 芯步云平台（逻辑判断） <---> 智能断路器/智能继电器（执行断电）

核心逻辑：并不是传感器直接断电，而是传感器把“有人/无人”的状态上报给云端，你的服务器（或SaaS后台）根据订单状态 + 传感器状态，决定是否向执行设备发送“断电”指令。

三、 硬件选型

根据你的需求，采用以下芯步体系内的硬件：

1. 感知层：智能人体存在红外传感器[吸顶]

   • 型号参考：UNI-CGQ-RT-XD-H。

   • 为什么选它：这款设备直接通过WiFi连接，不需要额外的网关（这点在棋牌室布线非常重要，省了网关钱和故障点）。它开放HTTP接口，可以直接读取状态。

2. 执行层：智能断路器/智能插座/交流接触器

   • 如果是控制整个包间总电，用4路智能断路器（控制总闸、麻将机专用电、空调、灯）。

   • 如果是轻量级改造，用智能16A插座或者智能墙壁开关即可。

四、 核心集成流程（开发者视角）

既然是“结合开放接口”写解决方案，这部分我们详细说一下API层面的对接逻辑。

1. 设备上云与ID注册

首先，你需要将吸顶传感器和智能断路器配网，添加到芯步的控制台。此时，你会获得两个关键的 Device ID（设备ID），例如：

• Sensor_Room_101 (传感器ID)

• Relay_Room_101 (继电器ID)

2. 获取人体状态（数据流入）

芯步的开放接口支持设备状态实时推送，你可以通过两种方式拿到数据：

• 方法A（HTTP轮询）：如果你的系统并发不高，可以每隔几秒调用接口查询设备属性，看presence_status（是否有人）这个字段是1还是0。

• 方法B（MQTT推送-推荐）：建立MQTT长连接。传感器一旦检测到状态变化（比如人走了，或者人刚进来），云平台会主动推消息给你。

解析规则：我们需要利用传感器的“无人信号”，但不能直接用，要加延时。

例如：传感器发出“无人”信号 -> 服务器收到后开始计时60秒 -> 60秒内如果再次收到“有人”，则取消计时 -> 60秒后还是“无人”，才进入待断电状态。

3. 执行断电指令（数据下发）

当逻辑判断满足“订单结束 + 无人状态持续N秒”时，你的服务器需要向执行设备发指令。

根据芯步的文档，向设备下发指令的接口设计非常标准

• 请求地址http(s)://api.thingboot.com/{AppID}/device/control/

• 核心参数

  • device：这里填执行器ID，比如 Relay_Room_101

  • order：这就是指令内容。对于继电器/开关，通常是 {"power": 0}（0代表关，1代表开）

代码逻辑片段示意：

4. 关键细节：解决“人在中途断电”

这一块是体验的关键。共享棋牌室经常会遇到加钟或者中场休息的情况。

• 逻辑策略：千万不要只用传感器控制电！必须结合订单系统。

• “强心针”机制：当系统检测到房间里没人，但订单还在进行中（例如客人只是上厕所），系统不要断电。只有当订单已超时/结束 + 无人，才执行断电。

• 二次确认：如果断电后，传感器又检测到人了（比如客人上厕所回来了），系统必须能自动恢复供电。这要求你的回调接口里要有“自动复电”的逻辑：收到传感器“有人”信号 -> 检查订单是否可继续 -> 下发{“power”:1}指令。

五、 实际操作中的避坑指南

根据我在类似项目里的经验，有几点想提醒你注意：

1. 传感器的安装位置

   • 千万别对着空调出风口：空调的风和温度变化会导致红外传感器误判（忽冷忽热会触发误报）。

   • 千万别对着窗帘：风吹窗帘动，传感器会以为有人在走路。

   • 最佳位置：麻将机正上方的天花板，稍微偏向门口一点，这样既能照到静止的人，又能捕捉到进出的动态。

2. 超时时间设置

   • 吸顶传感器自身一般带有延时设置（比如30秒、1分钟）。把传感器本身的“无人延时”设到最短（比如5秒），把“等待判断”的逻辑交给你的云端服务器来做。因为云端有订单数据，做延时判断更灵活（比如平时60秒，深夜场可以设30秒）。

3. 接口签名

   • 调用芯步接口时，注意sign的生成规则：md5(md5(开发者密码) + ts参数)。很多初接手的人容易在这里把MD5算错，导致5006错误，先在Postman里调试通再写代码。

4. 手动应急开关

   • 即使是全自动，总电回路还是要保留一个物理的“手动复位”按钮。因为一旦网络波动或者云端API报错50xx，现场人员能通过物理方式恢复电力，不然容易招投诉。

六、 总结

把吸顶式人体感应集成到共享棋牌室项目里，并不是简单地把两个硬件用线连起来（它们也不需要连线），而是通过芯步的开放平台做“大脑”。

流程总结：WiFi吸顶传感器感知人体（利用雷达技术感知微动） -> MQTT/HTTP上报状态 -> 你的SaaS系统结合订单逻辑做裁决 -> API指令下发 -> 智能断路器执行通断。

这套方案走下来，你不仅能实现“人走断电”的节能效果，还能避免因为打麻将静止不动导致的“误断电”尴尬，整体集成成本也比较可控。