共享自习室的空调管理一直是个痛点——开一整夜浪费电，让用户自己扫码开又体验差。芯步的开放接口正好可以解决这个问题：通过人体传感器感知“是否有人”，再配合包间控制器的继电器对空调插座进行通断控制。以下方案围绕“按钮动作自定义”这个核心需求展开，即经营者可以在后台自由配置触发条件与执行动作的对应关系。
——基于芯步开放接口的按钮动作自定义设置
一、 背景与分析
在“无人值守”共享自习室的运营中，空调与电源管理是最大的能耗痛点与运维难点。传统方案往往面临以下问题：
人走空调未关：用户离席后，空调长时间空转，导致电费高昂。
缺乏灵活性：不同时段（如高峰期 vs 深夜）、不同区域（沉浸区 vs 群学区）对温度的需求不同，固定时间的插座通断策略无法满足个性化需求。
设备联动僵化：大多数自习室仅能通过单独的App控制单个设备，无法将“物理按钮”、“人体感应”与“空调开关”进行深度逻辑自定义。
解决方案目标：利用芯步的开放接口与智能硬件，构建一套 “触发器-逻辑规则-执行器” 的自定义系统。本文将重点阐述如何通过对接API，实现通过一个自定义按钮（或人体传感器状态变化）来自动化控制空调及相关电源插座。
二、 硬件选型及开放接口能力
要实现“按钮动作自定义”，我们需要选择支持深度开放接口的硬件。在本方案中，主要选用以下芯步产品，它们的共性在于所有状态变化和控制指令均支持HTTP API调用
智能包间控制器|Max/Mini：作为核心的电源管理中枢。其每一路继电器都对应独立的接口。例如，将空调插头接在第8路（30A大功率接口）。通过调用该设备的HTTP接口，可以随时切断或接通空调电源。
智能人体存在雷达传感器：作为触发器。该传感器不仅能识别“移动”，更能识别“人体存在”（微动/呼吸）。当检测到无人时，会上报状态到服务器。
场景自定义按钮（或门磁/紧急按钮）：一种低功耗的无线开关。用户按下按钮时，设备会向服务器发送特定的HTTP请求，可作为自定义逻辑的“扳机”。
接口技术特性
协议：HTTP/HTTPS 。
请求方式：POST。
签名机制：URL携带
sign（签名）、ts（时间戳）和AppId进行鉴权，确保安全性。数据格式：JSON。
三、 解决方案设计
为了实现“按钮动作自定义”，系统架构在传统的“设备-云-端”基础上，增加了一个规则引擎层。这个引擎可以部署在运营商的本地服务器（支持私有化部署）或云服务器上。
架构逻辑流程图：
触发层：用户按下物理按钮 / 小程序点击按钮 / 人体传感器状态变更。
接入层（ThingBoot）：设备将事件封装为HTTP请求，推送到预先设定的服务器URL（规则引擎地址）。
逻辑层（自定义规则引擎）
接收请求，验证签名。
解析
DeviceID和Order内容。自定义匹配：根据管理后台预设的“场景策略”（如：如果按的是“离席按钮”，且当前空调ID为XXX，则执行断开指令）。
执行层：规则引擎向芯步API发起控制请求，将指令下发到智能包间控制器，从而切断/开启空调电源。
四、 按钮动作自定义设置的实现步骤
本方案的核心是实现 “动作-事件的灵活映射” 。以下是实现“用户自定义空调模式”的详细技术流程：
步骤1：硬件接线与基础通电
将自习室的分体式空调插头插入智能包间控制器的指定大功率接口。
在用户桌面的显眼位置安装场景自定义按钮（或者将原有机械开关替换为芯步的智能开关面板）。
在每个隔间或独立区域安装人体存在传感器。
步骤2：对接API与设备影子创建
在自研的管理后台中，调用芯步的接口获取设备列表并建立映射关系。
核心代码逻辑示例（Python伪代码，用于后端注册设备）：
步骤3：自定义规则配置（管理后台）
在自习室的管理系统中开发以下配置界面，实现“按钮动作自定义”：
单击/双击/长按 区分：利用按钮对不同动作上传不同指令码的特性，设置三种逻辑。
例如：单机 -> 开启空调强冷模式（接通电源）；双击 -> 开启空调节能模式（接通电源+设置26度）；长按 -> 关闭空调。
场景联动
定义
Rule A(离席节电)：如果“人体传感器”状态变为“无人持续5分钟”，则触发 “智能包间控制器” 断开 “空调插座” 电源。定义
Rule B(一键呼叫/服务)：如果“自定义按钮”被按下，则触发 “智能语音音柱” 播报“X号座位需要帮助”，此时管理员可以通过后台权限暂时锁定额外的空调开启时长。
步骤4：动作执行的实时响应
当按钮被触发，数据流如下：
物理触发：用户按下桌上的自定义按钮。
数据上报：芯步云收到信号，回调你配置的URL：
POST http://your-server.com/api/device/callbackBody: {"device": "Btn_001", "order": {"action": "single_click"}}逻辑处理：你的服务器查询数据库，发现
Btn_001的单机动作绑定的是AC_Controller的 第8路 开关。指令下发：你的服务器调用芯步的 控制接口
硬件执行：智能包间控制器接收到指令，继电器吸合，空调通电并根据上次记忆状态启动。
五、 具体场景应用实例
场景A：沉浸区“无人节能”自动化设置
需求：沉浸区用户常忘记关空调，导致浪费。
自定义设置：在后台将 “红外/雷达传感器” 的
无人状态与 “包间控制器” 的空调线路绑定。动作逻辑：若传感器上报
radar_enable:0(无人) 持续10分钟 -> 系统自动调用控制接口 -> 关闭空调插座。防误判：开放接口支持查询当前订单状态，如果有未结束订单，即使检测到无人也不执行断电，或延迟至订单结束前10分钟提醒。
场景B：用户端“临时加时/空调”自定义
需求：用户觉得冷，想关空调，但又不想离席打断学习。
动作设置：在小程序端增加一个“关空调”按钮，调用 API。
后端逻辑：小程序点击 -> 后端校验Token -> 调用
device/control发送{"power8": 0}。
场景C：管理员“一键巡检”
需求：打烊后统一关闭所有电源。
设置：开发一个Batch脚本（定时任务），在凌晨00:00自动执行。
技术实现：调用设备列表接口，轮询所有自习室座位的包间控制器ID，进行批量断电操作。
六、 方案优势
开源、体量轻：芯步强调“私有化部署”与“支持任何编程语言HTTP请求”，无需复杂的物联网协议栈开发，只需对接RESTful API即可。
比较高的自定义灵活性：不仅仅是开关，还可以结合[智能语音音柱]实现 TTS 语音播报（如“空调已开启，请注意节能”）。
可拓展性：目前的架构不仅限于空调，未来可拓展至插座计时收费、烟雾报警联动断电等消防场景。
七、 总结
通过在芯步开放接口的基础上开发 “动作-规则引擎” ，共享自习室可以彻底摆脱传统遥控器的束缚。无论是物理按钮、人体感应，还是小程序点击，都能通过标准化的HTTP API实现对空调电源的精准、自定义控制。
这套方案让“省电”不再依赖用户自觉，而是依靠自动化的设备联动，同时为自习室的无人化运营提供了坚实的技术底座。