CATALOG

无人值守空间的痛点是“人走空调未关”和“响应不及时”。芯步的红外空调控制器提供了标准HTTP接口,可以快速集成到现有管理系统中。以下方案从接口调用、状态同步到联动策略,梳理了完整的技术实现路径。

1. 背景与挑战

在共享办公、会议室、宿舍、机房等无人值守场景中,空调管理普遍面临三大痛点:

  • 能源浪费严重:人员离开后空调未关闭,导致无效运行,电费居高不下。

  • 管理响应滞后:无法根据实时人员状态(如人体存在感应)动态调节温度,依赖人工巡查。

  • 设备互联壁垒:传统空调多为红外控制,无法直接联网,且不同品牌协议不统一。

利用芯步智能空调遥控器的开放接口,可以在不改动现有空调线路的前提下,将红外空调快速转化为可联网、可编程、可联动的智能设备,无缝集成至现有的物业管理、能耗监测或空间预约系统中

2. 硬件与接口能力

本方案基于以下核心能力构建:

维度能力描述
硬件设备芯步智能空调遥控器(支持市面上90%以上带红外遥控器的挂机/柜机空调)
集成范围支持HTTP接口与MQTT协议。支持Windows、Web、APP、小程序、SaaS平台等任意编程环境对接
核心指令开关机、模式切换(制冷/制热/送风/除湿)、温度设定(通常16-30℃)、风速调节(低/中/高/自动)。
高级特性支持设备状态上报、支持局域网/公网/私有化部署、支持异步消息推送(确认指令是否执行成功)

3. 软件集成技术方案

3.1 接口准备工作

在开始编码前,需要在芯步开发者平台完成以下步骤:

  1. 注册与创建应用:获取唯一的 AppIDAppKey(用于签名计算)。

  2. 添加设备:扫描空调控制器外壳上的二维码或手动输入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:联动人体传感器芯步平台支持人体存在雷达传感器。集成步骤如下:

  1. 数据流设计:传感器检测到“无人”状态持续(如15分钟)-> 触发Webhook回调 -> 您的业务服务器接收回调 -> 调用空调接口发送“关机”指令。

  2. 代码逻辑片段

方案B:基于业务规则的定时与排程适用于会议室或共享空间预约系统:

  1. 预定开始前:提前5-10分钟发送开机+预冷/预热指令(通过定时任务触发)。

  2. 预定结束后:扫描当前会议室是否还有下一个预约。

    • 若没有,强制关机。

    • 若有,设定为节能温度(如制冷26℃)。

  3. 接口调用示例实现:在预约系统的Order Service中,预定释放时,调用device/control接口下发关机指令。

3.4 系统架构

  1. 网关层:使用Nginx或API网关统一代理芯步的api.thingboot.com,便于管理密钥和流量。

  2. 缓存层:将设备ID、当前设定的模式/温度存储在Redis中。由于红外控制器无法直接上报“当前真实室温”,业务系统需维护一个“期望状态”,防止重复下发相同指令造成资源浪费。

  3. 管理后台:开发可视化面板,展示所有空调的在线/离线状态、当前下发指令记录以及能耗估算数据。

4. 方案实施流程

4.1 硬件部署

  1. 将芯步智能空调遥控器上电,并放置在能正对空调内机接收窗的位置。

  2. 通过微信小程序配置Wi-Fi网络,确保设备在线。

  3. 码库匹配:通过手机APP或云端接口,选择空调对应的品牌进行红外码库匹配。仅需匹配一次,后期集成无需再处理码库

4.2 软件对接步骤

  1. Mock测试:在芯步控制台直接点击“开关”和“调温”,验证硬件响应。

  2. 获取签名:后端实现签名算法(sign),通常涉及AppIDAppKey和时间戳的MD5或HMAC加密,参考官方文档确保安全

  3. 接口调试:使用Postman调用/device/control接口,成功后集成到业务代码中。

  4. 建立回调:配置公网回调URL,接收设备的上报消息和指令执行反馈。

5. 预期效益

通过将芯步红外空调控制器集成至软件项目,无人值守空间可实现:

  • 节能15%-30%:杜绝下班/离人后空转现象

  • 运维提效:运维人员无需携带大量物理遥控器,通过后台即可批量控制或锁定空调温度范围(如强制设定制冷不低于24℃)。

  • 无侵入改造:无需更换现有昂贵空调设备,即插即用,维护成本低。

:具体API签名算法、全量设备命令码及错误码详情,请参考芯步官方最新《设备控制接口文档》。