共享台球厅要实现24小时无人值守，场景联动照明是基础也是关键——既要让用户开台即亮灯、离开现场时即关灯，又要避免“长明灯”浪费。芯步的开放接口正好解决这个问题：传感器检测到人体存在后上报数据，你的服务器做业务判断，再通过API下发给灯控器执行。以下是具体的落地实现方案。
1. 解决概述与设计目标
在共享台球厅的无人值守场景中，痛点在于：如何精准判断“谁需要使用哪张球桌”，并自动为其提供照明，同时避免能源浪费。
本方案基于芯步（ThingBoot）开放平台的API能力，结合智能人体存在传感器与智能断路器/灯控器，实现“预约即关联、落座即亮灯、离座即关灯、超时自动断”的闭环控制。
核心价值：
极致节能： 解决传统台球厅“长明灯”问题，降低电费成本。
提升体验： 用户手机上点“开台”，对应球桌灯光即刻点亮，无需呼叫服务员。
无人化管理： 订单结束后自动断电，防止逃单或忘记关灯。
2. 硬件选型与角色分工
要实现场景联动，主要依赖以下三类芯步生态硬件及兼容的执行器：
2.1 感知层（触发器）
推荐设备：芯步智能人体存在雷达传感器（吸顶版）
作用： 精准探测球桌周边是否有人。相较于普通红外传感器，雷达传感器不受静态人体（如坐着休息）影响，能持续反馈“有人”状态，防止打球过程中误判关灯。
接口特性： 支持
radar_enable（雷达开关）及环境数据实时上报。
2.2 执行层（控制器）
推荐设备：单火/零火智能灯控模块（多路）或多路断路器
作用： 直接控制每张台球桌正上方的专用照明灯。
接口特性： 支持
power（线路通断）命令，响应速度极快（80-120ms）。
2.3 边缘层（网关）
推荐设备：芯步智能网关
作用： 作为本地处理中心，即使公网断开，局域网内的联动依然正常执行。
| 设备类型 | 产品示例 | 核心职责 | 关键接口/命令 |
|---|---|---|---|
| 感知层 | 人体存在雷达传感器 | 探测区域活体目标，判断是否有人打球 | radar_enable, 有人/无人状态上报 |
| 执行层 | 智能灯控器 / 断路器 | 执行物理电路的通断，控制灯光 | power (1为开, 0为关) |
| 边缘层 | 智能网关 | 本地处理联动逻辑，承担协议转换 | 数据汇聚与指令下发 |
3. 场景联动逻辑设计
为了实现流畅的无人化运营，采用 “混合联动模式” ：以业务系统逻辑为主，传感器逻辑为辅。
第一种场景：用户开台 -> 自动亮灯
用户在小程序端完成支付，订单状态变为“进行中”。
系统后端调用芯步API
http(s)://api.thingboot.com/{AppId}/device/control/。参数示例：
{"device": "球桌对应灯控器ID", "order": {"power": 1}}。结果： 球桌顶灯亮起，同时传感器开始工作。
第二种场景：无人自动关灯
为避免用户中途离开现场时忘记关灯，设定时间循环检测机制：
雷达传感器持续检测该区域。
若连续 15分钟 未检测到任何人影。
传感器通过消息推送将“无人状态（
presence=0）”发送至服务器。服务器向对应灯控器下发
power:0指令，关闭灯光以节能。此时订单未结束，用户回来需通过小程序一键“续灯”重连。
第三种场景：超时断电与结账关灯
订单剩余时间不足 5分钟时，系统可推送提醒。
订单时间归零或用户点击“结账”。
系统调用API接口关闭灯控器电源。
即使传感器检测到有人（用户在收拾东西），由于订单已结束，系统不再供电，促使用户离开现场时。
4. 接口集成实施步骤
4.1 环境准备（控制台配置）
登录芯步开放平台，创建应用，获取唯一的
AppId和App Secret。在平台中添加设备（扫码或手动输入SN码），获取设备ID（如
820720）。配置消息推送URL（Receive Address）：这是你的后端服务器公网地址，用于接收传感器的有人/无人事件。
4.2 核心API调用示例
在后端开发中（Java/Python/Go等），核心逻辑是生成带签名的请求。
场景：结账关灯（Go语言伪代码逻辑）
4.3 关键数据处理（Webhook接收）
你需要编写接口来接收传感器的状态推送。
接收流程：
雷达传感器上报数据：“有人进入”。
芯步平台POST JSON数据到你的
https://yourdomain.com/api/yooyo/callback。你的后端解析数据，判断：
如果当前订单状态为“进行中” 且 当前灯是熄灭状态 -> 触发开灯指令（重开场景）。
如果当前订单状态为“已完成” -> 忽略本次上报（保持关灯）。
5. 高级联动策略与优化
5.1 全局节能策略
全屋总控： 若凌晨2点-6点，所有传感器反馈“无人”状态持续超过30分钟，系统自动触发整店电源切断，仅保留网关与服务器，极致省电。
分区控制： 若该时段只有A区有人打球，系统自动保持A区供电，B、C、D区自动休眠。
5.2 灵活计费融合
通过API获取实时功率数据，实现动态计费
如果检测到球桌灯已关闭（用户离开现场时休息），系统可自动暂停计费。
用户回到座位传感器探测到人，或者手动在APP端恢复供电后，自动恢复计费。
注意：这种模式需要配合明确的收费规则说明，避免引起争议。
6. 总结
通过在共享台球厅部署芯步智能传感器与灯控硬件，并利用其 “设备实时状态上报”与 “服务端下发指令” 的核心API能力，开发者可以快速搭建一套类似于“无人工厂”的照明控制系统。
这套方案不仅实现了物理上的“人在灯亮，人走灯灭”，更关键的是它让灯光与线上订单系统强绑定，彻底杜绝了逃单和私开台的现象，是实现24小时无人值守台球厅的基础设施。开发者需重点关注 power 和 radar_enable 两个命令的交互逻辑，这涵盖了90%的照明控制需求。