共享茶室的灯光控制痛点在于：用户随机到店、离店时间不确定，传统定时或手动方式难以兼顾“体验”与“节能”。芯步的开放接口恰好能解决这个问题——通过传感器发现“有人”就亮灯，“无人”就关灯，还能和门锁、预约系统联动。以下方案聚焦如何用HTTP接口快速实现这些自定义逻辑。
一、 项目需求与背景分析
在共享茶室场景中，空间被分割为多个独立的包间。运营的痛点在于：“人离未关灯”导致的能源浪费与“用户到店昏暗”带来的低劣体验。传统的照明系统无法感知人员状态，只能依靠用户自觉或人工巡检。
本方案的目标是利用芯步的智能硬件开放接口，构建一套基于 “感知-决策-执行” 闭环的自定义联动逻辑系统。通过人体存在传感器和智能控制器的结合，实现“人来灯亮、人走灯灭、预约预热”的全自动化管理。
二、 硬件选型与角色定义
基于芯步官网提供的产品目录，为实现上述目标，选定以下硬件：
| 设备类型 | 推荐产品 | 核心作用 | 关键接口/能力 |
|---|---|---|---|
| 感知层 | 智能人体存在雷达传感器 | 检测包间内是否有人。区别于传统红外，雷达能检测静止坐姿的人体（如靠在沙发上喝茶的客人），防止“人在灯灭”。 | 实时上报 有人/无人 状态至服务器。 |
| 执行层 | 智能通用控制器（16路） 或 智能开关 | 控制灯光的物理通断。安装在茶室的配电箱内，直接控制射灯、灯带、主灯等回路。 | 接收服务器下发的 通电/断电 指令，支持HTTP API控制。 |
| 交互层 | 后台管理系统/小程序 | 运营方配置联动逻辑；用户侧可通过小程序临时自控。 | 调用芯步开放API。 |
三、 技术架构与联动原理
本方案采用标准的物联网三层架构，利用芯步全开放的HTTP接口实现数据互通。
1. 架构图示意
flowchart TD
A[人体存在传感器] -- MQTT/HTTP --> B[芯步云平台]
C[智能控制器] -- MQTT/HTTP --> B
B -- 状态推送/API调用 --> D[用户自建业务服务器
共享茶室SaaS系统]
D -- 自定义联动逻辑
下发控制指令 --> B
B -- 执行指令 --> C
C -- 物理断通电 --> E[灯光回路]
F[商户APP/管理后台] -- 配置联动规则 --> D
G[用户小程序] -- 临时控灯 --> D2. 核心工作流：人来灯亮
感知：传感器雷达模块探测到人体移动或微动，
radar_enable状态变为true。上报：设备通过HTTP POST将
{"device": "sensor_001", "status":"occupancy_detected"}推送到您的服务器地址。决策：您的服务器校验该包间当前订单状态（是否为已预订/使用中）。
执行：服务器调用芯步
device/control接口，向对应的控制器下发{"device":"controller_01", "order":{"power":1}}。完成：控制器闭合继电器，灯光亮起。
四、 自定义联动逻辑的具体实现方案
以下是共享茶室场景中亟需的三种自定义逻辑配置方案
方案一：基于“人体存在”的动态节律逻辑
这是解决节能与体验矛盾的核心。
逻辑描述
高精度探测：利用雷达传感器（存在雷达模块）识别“有人”与“无人”。
防误判延时：为避免短暂离座（如上厕所）导致关灯，设置 “无人延时” 逻辑。当传感器上报
无人后，服务器启动倒计时（如15分钟）。二次确认：15分钟内持续收到
无人信号，服务器才发送关灯指令；若中途收到有人信号，立即重置倒计时，保持灯光。
接口实现：您的服务器接收传感器消息后，通过定时器（Timer）实现延时任务，而非依赖设备本身。
方案二：基于“订单状态”的场景联动
解决用户未到时提前开灯或超时离开现场时的问题。
预约预热逻辑（软联动）
用户在手机上预订了“14:00-17:00”的包间。
触发：您的SaaS系统在14：00检测到订单生效。
动作：自动调用控制接口，开启茶室内的待客灯（通常功率较低的氛围灯），并关闭空气循环。这给了用户“欢迎”的仪式感，且避免了全亮带来的突兀。
超时断电逻辑
用户订单结束时间到，且未续费。
触发：服务器主动调用接口切断该包间总电源。
方案三：基于“多设备状态”的优先级仲裁逻辑
解决同时收到语音、手动、传感器指令时的冲突问题。
场景：当传感器检测到无人准备关灯时，用户通过面板手动开灯，或通过语音助手发来指令。
仲裁策略：在您的服务器端建立状态机。
手动/APP控制：优先级最高。当收到手动指令时，服务器暂时挂起“无人自动关灯”的定时任务，保持灯光常亮一段时间。
强制节能：若服务器检测到包间已退租（订单结束），无论雷达传感器是否误报有人，强制下发关灯指令，防止设备故障导致浪费。
五、 接口开发关键步骤
基于芯步的开放能力，开发集成流程如下：
步骤 1：设备注册与上线
购买芯步的传感器和控制器。
通过芯步后台获取
AppId和AppKey。将设备通电配网，记录下各设备的
Device ID（如：灯光回路ID、传感器ID），并在您的SaaS系统中绑定对应的“茶室房号”。
步骤 2：配置消息推送接收（服务端侧）
芯步的设备是主动上报数据的，您需要提供一个 HTTP/HTTPS 接口 URL 配置在芯步云平台。
接收示例：当传感器状态变化时，芯步会POST数据到您的URL。
您的任务：解析JSON数据，提取
device_id和status(如radar_enable=0)，触发业务逻辑。
步骤 3：下发控制指令
当您的服务器决定开关灯时，需调用芯步的 device/control 接口。
请求地址
http://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}核心代码逻辑（伪代码）
步骤 4：自定义逻辑配置界面（Low-Code）
为了方便运营人员修改规则，您可以在自己的管理后台开发一个“联动规则引擎”界面：
数据源：选择“人体传感器” -> “无人状态”。
条件：持续时长 > 10分钟。
动作：选择“控制器” -> “第1路灯光” -> “关闭”。
保存：将这套配置存储到您的数据库，由您的服务器实时执行。
六、 总结
极致节能：结合雷达存在式传感与服务器端延时逻辑，确保非营业时段0照明能耗。
高灵活性：芯步的HTTP接口无开发语言限制，可轻松集成进现有的共享茶室SaaS或小程序中，无需关心底层无线协议（Wi-Fi/蓝牙）差异。
体验升级：通过“订单联动”，实现未进门灯光已准备就绪，离店后自动清扫关灯，提升共享空间的科技感与私密性。
私有化部署能力：芯步支持局域网和私有化部署，确保在公网不稳定时，茶室内部的本地服务器依然能控制灯光，保障业务连续性。