无人值守空间的痛点是“人走空调未关”和“响应不及时”。芯步的红外空调控制器提供了标准HTTP接口,可以快速集成到现有管理系统中。以下方案从接口调用、状态同步到联动策略,梳理了完整的技术实现路径。
1. 背景与挑战
在共享办公、会议室、宿舍、机房等无人值守场景中,空调管理普遍面临三大痛点:
能源浪费严重:人员离开后空调未关闭,导致无效运行,电费居高不下。
管理响应滞后:无法根据实时人员状态(如人体存在感应)动态调节温度,依赖人工巡查。
设备互联壁垒:传统空调多为红外控制,无法直接联网,且不同品牌协议不统一。
利用芯步智能空调遥控器的开放接口,可以在不改动现有空调线路的前提下,将红外空调快速转化为可联网、可编程、可联动的智能设备,无缝集成至现有的物业管理、能耗监测或空间预约系统中。
2. 硬件与接口能力
本方案基于以下核心能力构建:
| 维度 | 能力描述 |
|---|---|
| 硬件设备 | 芯步智能空调遥控器(支持市面上90%以上带红外遥控器的挂机/柜机空调)。 |
| 集成范围 | 支持HTTP接口与MQTT协议。支持Windows、Web、APP、小程序、SaaS平台等任意编程环境对接。 |
| 核心指令 | 开关机、模式切换(制冷/制热/送风/除湿)、温度设定(通常16-30℃)、风速调节(低/中/高/自动)。 |
| 高级特性 | 支持设备状态上报、支持局域网/公网/私有化部署、支持异步消息推送(确认指令是否执行成功)。 |
3. 软件集成技术方案
3.1 接口准备工作
在开始编码前,需要在芯步开发者平台完成以下步骤:
注册与创建应用:获取唯一的
AppID和AppKey(用于签名计算)。添加设备:扫描空调控制器外壳上的二维码或手动输入ID,将设备绑定到应用下,获取唯一的
device设备ID。
3.2 核心接口调用逻辑
所有控制逻辑基于向指定设备下发指令实现。接口地址遵循以下格式http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
3.2.1 空调启停与温度设置
在后端服务中,无需关心红外码库,只需发送标准JSON指令即可。请求示例 (JSON POST)
关键点order字段支持JSON字符串格式,且在HTTP GET或POST方式中均兼容,极大降低了前端拼接参数的复杂度。
3.2.2 执行结果的状态同步
由于红外信号属于“发射即忘”。接口返回code:200,仅代表云端成功向设备发送了指令,不代表空调真的开机了(例如有物体遮挡红外)。针对需确认的场景,应采用异步消息推送机制
在命令中携带唯一
extra字段(如订单号或时间戳),云端在接收到设备反馈后会原样推送给服务器,以此确认指令已送达空调并被执行。
例如下发指令时携带:{"power":1,"extra":"ORDER_001"},后续可通过回调获知该指令的执行状态。
3.3 实现无人值守自动化(联动策略)
无人值守的核心在于“感知+决策+控制”。单纯的红外控制器只能遥控,需结合传感器或业务逻辑。
方案A:联动人体传感器芯步平台支持人体存在雷达传感器。集成步骤如下:
数据流设计:传感器检测到“无人”状态持续(如15分钟)-> 触发Webhook回调 -> 您的业务服务器接收回调 -> 调用空调接口发送“关机”指令。
代码逻辑片段
方案B:基于业务规则的定时与排程适用于会议室或共享空间预约系统:
预定开始前:提前5-10分钟发送开机+预冷/预热指令(通过定时任务触发)。
预定结束后:扫描当前会议室是否还有下一个预约。
若没有,强制关机。
若有,设定为节能温度(如制冷26℃)。
接口调用示例实现:在预约系统的
Order Service中,预定释放时,调用device/control接口下发关机指令。
3.4 系统架构
网关层:使用Nginx或API网关统一代理芯步的
api.thingboot.com,便于管理密钥和流量。缓存层:将设备ID、当前设定的模式/温度存储在Redis中。由于红外控制器无法直接上报“当前真实室温”,业务系统需维护一个“期望状态”,防止重复下发相同指令造成资源浪费。
管理后台:开发可视化面板,展示所有空调的在线/离线状态、当前下发指令记录以及能耗估算数据。
4. 方案实施流程
4.1 硬件部署
将芯步智能空调遥控器上电,并放置在能正对空调内机接收窗的位置。
通过微信小程序配置Wi-Fi网络,确保设备在线。
码库匹配:通过手机APP或云端接口,选择空调对应的品牌进行红外码库匹配。仅需匹配一次,后期集成无需再处理码库。
4.2 软件对接步骤
Mock测试:在芯步控制台直接点击“开关”和“调温”,验证硬件响应。
获取签名:后端实现签名算法(
sign),通常涉及AppID、AppKey和时间戳的MD5或HMAC加密,参考官方文档确保安全。接口调试:使用Postman调用
/device/control接口,成功后集成到业务代码中。建立回调:配置公网回调URL,接收设备的上报消息和指令执行反馈。
5. 预期效益
通过将芯步红外空调控制器集成至软件项目,无人值守空间可实现:
节能15%-30%:杜绝下班/离人后空转现象。
运维提效:运维人员无需携带大量物理遥控器,通过后台即可批量控制或锁定空调温度范围(如强制设定制冷不低于24℃)。
无侵入改造:无需更换现有昂贵空调设备,即插即用,维护成本低。
注:具体API签名算法、全量设备命令码及错误码详情,请参考芯步官方最新《设备控制接口文档》。