共享棋牌室的“人走断电”是运营能耗和安全的刚需，而吸顶式红外/雷达传感器的选型与对接是其中的技术关键。芯步的产品体系以开放HTTP接口为核心，可以很方便地将传感器感知与执行器控制串联起来。以下方案避开传统硬接线方式，采用纯云/局域网API对接架构。

1. 概述与选型

在共享棋牌室场景中，实现“人走断电”的痛点在于：如何准确判断“无人”状态，并在断电后不影响下一次用户的正常通电。

传统方案通常采用“智能插座+机械按钮”，但这无法解决用户离开现场时不按按钮或忘记关空调/麻将机的问题。因此，必须引入吸顶式人体存在传感器来实现环境的自动化感知。

设备选型：

• 控制核心：推荐使用 芯步智能包间控制器（Mini版） 。该设备支持4路输出（门锁、照明、麻将机、空调），可直接接220V强电，且支持HTTP API控制。

• 感知核心：推荐使用 芯步智能人体存在雷达传感器（吸顶式） 。注意，必须选用雷达（毫米波）版，而不是普通红外版。因为麻将室用户久坐不动，普通红外（PIR）无法检测静止人体，会误判断电；雷达版能检测微动（呼吸），确保人在不断电。

2. 对接设计

本方案采用“传感器上报 — 开发者服务器决策 — 控制器执行” 的闭环逻辑。所有设备均通过WiFi 2.4G直连云端或局域网服务器，无需网关中转，响应时间约80-120ms。

架构逻辑图

1. 用户下单：小程序/后台系统生成订单，通过API向芯步控制器下发power=1（通电）指令。

2. 状态监测：吸顶传感器实时检测区域人员存在，状态变化时主动推送到您的服务器。

3. 断电逻辑：服务器收到“无人”状态 -> 开始倒计时（如10分钟）-> 倒计时结束再次确认“无人” -> 向控制器下发power=0（断电）指令。

4. 应急控制：用户在小程序点击“结束订单”，直接调用API断电。

3. 详细对接步骤

3.1 硬件安装与接线

1. 吸顶传感器安装

   • 安装在包间天花板的中央位置，感应面朝下。

   • 接线：提供220V交流电供电（L/N线）。虽然它叫“开关”，但在本方案中，它实际上是一个“探测器”，不需要串联进灯具回路，而是独立供电，仅作为信号源。

2. 智能控制器安装

   • 安装在配电箱或吊顶检修口。

   • 接线：输入端接总进线；输出端分别接入麻将机、空调、照明灯、门锁的零火线。

3.2 设备激活与开发配置

在开始API对接前，需先完成设备的网络配置：

1. 注册与添加：登录芯步物联网控制台，创建项目（AppId），将购买的两台设备（传感器ID、控制器ID）通过WiFi配网工具绑定到该账号下。

2. 回调地址配置：在控制台设置“第三方推送”URL（您的服务器公网地址）。

   • 配置项：消息推送地址设置为 https://您的域名/api/yoyo/callback

   • 作用：当传感器检测到有人/无人时，芯步云端会自动向此地址发送JSON数据包。

3.3 API接口深度对接

芯步全系产品均采用HTTP请求进行控制，签名机制（Sign/Token）保证安全性。

A. 控制设备通电/断电

场景：当用户下单成功或系统检测到无人超时时，控制房间供电。

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

• 请求参数示例

  { "device": "控制器设备ID", // 例如:4820123 "order": { "power": 1 // 1:闭合开关（通电），0:断开开关（断电） } }

• 实战逻辑：用户点击小程序“开门”，后台调用此接口向控制器ID发送power:1，麻将机和空调上电。

B. 接收传感器上报（关键：人走断电）

场景：服务器被动接收传感器状态，触发业务判断。

• 数据接收：芯步云端向您的服务器推送消息。

• 接收的数据格式

  { "device": "传感器设备ID", "msg_type": "report", "data": { "radar_enable": 1 // 1:检测到有人存在，0:无人 } }

• 业务代码逻辑（伪代码）

  # 接收到传感器推送 if data.radar_enable == 0: # 无人状态，启动延迟断电任务（例如延迟 600 秒） # 注意:为避免用户短暂离开（如去前台买水）导致设备关机，这里必须延时 schedule_job(room_id, delay=600) else: # 有人状态，取消延迟任务 cancel_job(room_id) # 如果订单还在有效期内，保持通电；如果订单结束但人在里面，告警或续费提醒

C. 特殊场景：手动强制断电

场景：用户点击“退场”或管理员远程操作。

• 命令

  { "device": "控制器设备ID", "order": {"power": 0} }

3.4 核心逻辑：反常识的“红外感应开关”接线

重点提醒：您提到的“吸顶式智能红外感应开关”如果按照家庭灯控接法（串接在灯具回路中），在共享棋牌室会出现逻辑灾难（比如人坐在麻将机前不动，灯会灭且无法触发）。

正确对接方式（IO检测方式）：

1. 放弃强电带载功能：将吸顶开关的 “OUT”输出端 视为一个 信号线，而不是电源线。

2. 接入控制器：将传感器的输出信号线接入到芯步控制器预留的传感器接口（GPIO/DI口）。

   • 逻辑：传感器检测到人 -> 内部继电器吸合 -> 连通信号 -> 控制器读取到通断 -> 通过网络上报给服务器“有人”。

   • 好处：服务器完全掌握逻辑，可以自由编程（例如：无人15分钟才断电，而不是人一走就断电），且避免了传感器直接切断强电导致的麻将机数据丢失问题。

4. 落地注意事项

1. 探测死角与安装位置：吸顶传感器感应角度通常为360度（雷达）或110-145度（红外），安装高度2.5-3米。麻将机的四角桌腿可能遮挡信号，将传感器安装在麻将桌正上方稍偏的位置。

2. 防止订单冲突：如果系统正在执行“无人断电”倒计时，用户突然推门回来（传感器变有人），程序必须能识别并中止断电，保持当前订单，无需重新下单。

3. 私有化部署（可选）：芯步支持纯局域网或私有云部署。如果您的棋牌室网络不稳定，在本地服务器部署接收程序，这样断外网时，局域网内的设备仍能通过本地IP通信控制，提高稳定性。

4. 区分“有人/无人”与“有订单”

   • 若传感器检测“无人”且 订单状态=进行中 -> 触发断电倒计时。

   • 若传感器检测“有人”且 订单状态=未开始/已结束 -> 触发安防告警（非法闯入）。

5. 总结

通过将吸顶式红外/雷达传感器作为数据采集端，芯步智能控制器作为执行端，利用其开放且标准的HTTP API接口，您可以快速构建一套稳定的共享棋牌室控制系统。

• 对于开发者：只需要关注业务逻辑（订单状态+传感器值=动作），无需关心底层硬件通讯协议。

• 对于最终用户：实现了真正的“零接触”体验——扫码即通电，离开现场时自动断电。