芯步的开放接口基于HTTP API和MQTT协议，支持人体传感器与照明设备之间的双向通信和场景联动。以下方案从设备选型、接口对接到底层场景设计，逐步说明如何在店铺中实现“人来灯亮、人走灯灭”的自动化控制。
1. 项目概述与联动逻辑
在零售店铺、展厅或餐厅等商业场景中，照明不仅提供基础亮度，更承担着引导视线、营造氛围的作用。传统的独立感应头往往只能实现简单的“亮/灭”，无法与其他设备（如空调、安防摄像头、语音迎宾器）协同工作。
本方案基于芯步开放平台的 API 接口，将店铺内的智能人体存在传感器与智能照明设备（开关/调光器）通过云端或局域网逻辑进行绑定。核心目标是实现“精准感知、多端响应”，例如：当传感器探测到顾客进入某个陈列区时，不仅顶灯亮起，同时射灯调整角度亮度，甚至联动语音音柱播放“欢迎光临”。
2. 设备选型与部署
要实现稳定可靠的联动，需根据店铺物理环境选择合适的硬件。的硬件组合如下：
感知层：智能人体存在传感器
选型：传统红外传感器（PIR）在人体静止（如蹲下看商品）时容易误判为无人。选用芯步的双模传感器（红外+雷达），静态探测和动态探测的结合了此场景下的需求，可检测毫米级微动（如呼吸、微小肢体动作），确保顾客在仔细挑选商品时灯光不会熄灭。
部署位置：安装在店铺出入口、货架过道上方或试衣间顶部。
执行层：智能照明控制器
场景 A（存量灯具改造） ：安装 智能墙壁开关，直接替换原有墙壁开关，控制整路射灯或筒灯的通断。
场景 B（无主灯/调光需求） ：对于需要营造氛围（如咖啡店、服装店），可能需要用到 智能可调光模块，支持亮度百分比调节。芯步开放接口中支持向设备下发如
{"power":1, "brightness":80}等指令。
扩展层：智能语音音柱
为了增强体验，可部署智能语音音柱。一旦传感器触发，可立即通过接口下发播放指定 welcome.mp3 的指令，实现“声光联动”。
3. 技术对接：基于开放接口的实现方案
芯步开放平台提供标准的 HTTP API 和 MQTT 两种对接方式。推荐使用 服务端（Server）中转联动 模式，原因是可以处理复杂的逻辑判断（如时间段过滤、防抖动处理），且不依赖特定网关的本地算力。
（1） 消息订阅与接收当顾客进入店铺，传感器状态由 无人 变为 有人。芯步会通过 消息推送 机制，主动将该状态变化发送至开发者搭建的后台服务器。
设备上报的数据示例如下：
开发者在服务器端接收到此消息后，需要进行逻辑判断（如：是否在营业时间段？防重复触发过滤？），然后触发下一步的控制指令。
（2） 向照明设备下发指令服务器判断需要开灯后，调用芯步的 “向设备下发指令” 接口 。
请求地址：
http(s)://api.thingboot.com/{AppID}/device/control/请求方法：
POST核心参数
device：照明设备 ID（如Light_01）。order：具体指令。此处设置为{"power": 1}开启灯光，或{"power": 1, "brightness": 80}（如果支持调光）。
（3） MQTT 实时控制（局域网低延时方案）对于网络环境较好的店铺局域网，可采用 MQTT 协议。服务器向主题 api/{AppID}/device/control 发布消息，设备端订阅该主题，实现毫秒级响应。
4. 核心场景联动逻辑设计
第一种场景：店内“人来灯亮、人走延时灭”
这是最基础但也最考验传感器精度的应用。
触发：传感器状态变为
有人。动作：控制照明设备
power设为1。进阶逻辑：为了避免顾客静止时灯灭，服务端需设定“无人延迟确认机制”。即传感器上报“无人”后，服务端不立即关灯，而是等待 3-5 分钟。若期间再次收到“有人”则取消关灯指令；若持续“无人”则执行关灯。
第二种场景：试衣间/库房“防误关”
店铺试衣间通常需要私密性，如果完全自动化，顾客在里面换衣服（动作幅度小）容易导致灯灭。
硬件保障：必须使用双模传感器。雷达波可以穿透布料和衣物，检测到正在换衣的人体微动，避免因红外被遮挡而误判无人。
联动：检测到有人 -> 控制试衣间专用灯带亮白光亮模式。
第三种场景：打烊后布防联动（安防模式）
触发：在设定的“深夜时段”，主出入口传感器触发“有人”。
动作
LED 警示灯：不开启明亮照明（避免惊扰），而是开启 安防警示灯（红蓝闪烁模式，需设备支持或通过智能插座控制继电器实现）。
语音音柱：通过 API 下发指令播放预设的高分贝警报音或“您已进入监控区域”语音。
消息推送：服务器向店主手机推送闯入告警。
场景四：接待模式（欢迎联动）
触发：入口传感器探测到人。
动作：开启主照明 + 开启指定射灯（重点照明） + 语音播报“欢迎光临”。这种情况对多设备并发控制要求较高，在通过
device/control/接口下发时，需根据实际需求支持多设备ID传输。
5. 数据交互与运维价值
接入芯步开放接口不仅仅是实现自动化控制，更重要的是数据采集。
通过接口不仅可以下发命令，还可以读取设备上报的状态数据进行商业分析
客流量统计 (People Counting)利用门磁传感器或人体传感器的触发频率，统计每日进店人数。结合 POS 机销售数据，可以计算出“提袋率”或“转化率”。如果在某时段人数多但成交少，可以反推是否需要调整灯光亮度或色温以改善购物体验。
能耗监测与节能分析智能照明设备通常支持电压/电流上报。系统可以自动记录并生成报表，展示安装联动系统前后电费的对比。直观的数据可以帮助商家验证 ROI（投资回报率）。
设备运维接口提供设备在线/离线状态查询。如果某个照明开关离线，后台会自动告警，店员无需逐个检查灯具，降低运维成本。
6. 实施注意事项
网络覆盖：传感器和智能开关依赖 WiFi 或网关，店铺内需保证信号覆盖无死角，尤其是在金属货架较多的区域。
场景防抖处理：在编写服务器联动代码时，需注意控制循环的问题。即：传感器触发开灯 -> 灯光亮起导致传感器附近温度轻微变化 -> 传感器误以为新状态变化。应尽量使用 MQTT 或直接 API 控制，并设置合理的触发冷却时间（Cooldown）。
手动优先原则：部分店员可能需要在夜间盘点货物而长时间静止。在 API 对接时增加“强制常亮”逻辑（例如：墙壁开关物理按键按 2 次触发忽略传感器指令模式），确保灵活性。
私有化部署（可选） ：对于数据安全要求比较高的店铺（如奢侈品旗舰店），芯步支持私有化部署方案，联动指令仅在局域网内闭环，不上传公网，确保店铺运营数据安全。
通过以上方案，店铺可以利用芯步的智能硬件与开放接口，将普通的照明系统升级为具备场景感知能力的智能系统，实现节能降耗与顾客体验的双重提升。