芯步的智能空调红外控制器提供开放的HTTP接口，支持任何能发起网络请求的编程语言直接调用，可快速集成到OA、ERP、企业微信、自建APP等各类软件系统中。以下是完整的技术集成方案。
1 背景与概述
在现代办公环境中，空调系统的能耗管理及智能化控制已成为企业降本增效的重要环节。传统办公空调通常配备红外遥控器，不仅难以实现集中管理，还经常出现下班忘关、区域过度制冷/制热、无区域区分控制等痛点。芯步的智能空调红外控制器（下称“红外控制器”）正是为解决上述痛点而设计的硬件设备。它通过模拟红外遥控信号，能够在无需更换现有空调设备的前提下，将普通空调升级为可远程控制、定时开关、温度/模式/风速精细化调节的智能终端。
本方案的核心在于利用芯步开放的HTTP API接口，将红外控制器的全部功能深度集成至企业现有软件系统（如OA、ERP、企业微信、钉钉、自研APP等），实现基于人员、时间、环境温度等多维度的自动化空调管理。
红外控制器支持市面上90%以上带红外遥控器的空调品牌，涵盖壁挂机、柜机、中央空调（通过线控器改造）等多种类型。集成完成后，软件系统可实时控制空调的开关、制冷/制热/送风/除湿模式切换、温度（通常16℃~30℃范围）、风速（自动/低/中/高）及摆风等全部功能。
2 系统设计
集成方案采用典型物联网三层架构，确保控制指令稳定可靠、业务逻辑灵活可扩展。整体架构如下图所示：
| 层级 | 组件 | 功能描述 |
|---|---|---|
| 应用层 | 企业OA/自研APP、Web管理后台、定时任务引擎 | 下发控制指令、展示设备状态、配置自动化策略、处理业务逻辑 |
| 云平台层 | 芯步云平台（API服务） | 设备注册管理、指令签名认证与转发、设备状态上报、高并发处理 |
| 感知层 | 智能空调红外控制器（硬件） | 接收云端下发的指令，转换为红外信号控制空调；反馈执行状态 |
数据流向说明：用户在企业微信点击“开启空调” → 自研后端接收到请求 → 调用芯步HTTP接口，携带签名及设备ID → 芯步平台校验签名成功后，将指令推送给对应的红外控制器 → 控制器发射红外信号控制空调。
为保障指令执行成功率，系统同时支持“局域网（LAN）”控制模式。当软件后端与红外控制器处于同一局域网段时，可选择私有化直连控制，降低公网延迟依赖，提升控制稳定性。
3 核心集成步骤详解
3.1 准备工作：获取API凭证与设备ID
集成前需完成以下准备工作：
硬件安装：将红外控制器放置在能直对空调红外接收窗的位置（距离≤8米），通过USB线供电并确认指示灯状态正常。
设备配网：使用“芯步”APP为控制器配置Wi-Fi网络，确保设备在线状态。
获取密钥：登录芯步开发者控制台，创建应用获取
AppID和AppSecret，用于API签名认证。获取设备ID：在控制台设备列表中找到已配网的红外控制器，复制
Device ID。此ID用于精确定位哪一台硬件设备。
3.2 API调用机制与签名算法
芯步接口采用HTTP POST方式进行设备控制，为保证安全性，每次请求需携带动态签名。开发者需生成 sign 和 ts（时间戳）参数与请求一同发送。
接口示例POST https://api.thingboot.com/{AppID}/device/control?sign=abc123&ts=1720000000
签名生成规则（伪代码逻辑）
将请求参数（如设备ID、指令）与
AppSecret按字典序排序拼接。使用MD5或约定的哈希算法生成签名字符串。
将生成的签名与当前毫秒级时间戳放入请求URL或Header中。
3.3 基础功能：开关与温度调节
针对办公场景最常见的“下班断电”和“工位温度调节”需求，软件需封装以下JSON参数，通过POST请求发送至接口order字段
开关机控制
开启：
{"power":"1"}关闭：
{"power":"0"}
模式与温度复合控制
制冷26℃：
{"mode":"cool","temp":26}制热22℃：
{"mode":"heat","temp":22}送风模式：
{"mode":"fan"}
风速调节
自动风：
{"windspeed":"auto"}低风：
{"windspeed":"low"}
集成模式：在软件界面中直接设计遥控器风格的滑块或按钮，将用户操作实时映射为上述JSON字符串下发。
3.4 高级功能：批量控制与定时任务
批量控制
对于开放办公区或会议室集群，一台软件后台往往需要管理多台红外控制器。芯步接口支持单次请求控制多个设备：
请求参数：在
device字段中以英文逗号分隔多个Device ID。执行示例：全部开启，
device="DEV001,DEV002,DEV003"，order={"power":"1"}。智能联动：若某个大型办公区需要批量统一将空调设为26℃制冷低风，只需计算一次签名，极大减轻后端服务器压力。
定时任务
定时任务无需实时请求，适合配置策略后交由平台自动执行：
典型场景1：工作日早上8:30开空调，下午18:30关空调。
典型场景2：午休时间（12:00-13:30）将全办公室温度自动上调1℃。
实现的方式是：软件后端调用芯步的“定时任务创建接口”，传入设备ID、Cron表达式（或具体时间点）及指令内容。到达设定时间后，芯步云平台会自动下发指令，即使软件服务器此时离线也不影响。
4 场景化业务落地
根据搜索结果中关于学校集中监控、语音控制及其他智能家居集成的思路，本方案在软件中实现以下三个典型场景
| 场景名称 | 触发条件 | 软件执行动作 | 业务价值 |
|---|---|---|---|
| 下班强提醒与联动关空调 | OA系统检测到员工最后一人打卡离开（或下班时间后15分钟） | 调用红外控制接口关闭对应工位/会议室空调；若接入门禁系统，可设置为“布防时自动关空调” | 节能：杜绝通宵运行，预计制冷季可降低15%-20%能耗 |
| 会议室动态空调管理 | 会议系统接口检测到会议室预定开始前10分钟 | 自动开启对应会议室空调，并设为预设温度（如24℃制冷）；会议结束后联动关闭 | 提效：无需会务人员逐一操作，提升智能化体验 |
| 工位个性化微环境 | 员工通过自研APP/小程序手动点击 | 即时调整自己所在区域的温度与风速；可预设“离家模式”一键关停个人区域设备 | 舒适：解决“有人嫌冷有人嫌热”的矛盾 |
5 集成注意事项与最佳实践
信号覆盖与多设备布局：若办公室空间较大或有隔断，单台红外控制器可能无法覆盖所有区域。按空调室内机1:1配置控制器。软件后台的设备管理模块应支持“区域/工位”标签化管理，避免控制错乱。
状态同步机制：由于红外控制是单向通信（控制器发射信号后无法物理读取空调面板状态），可能出现软件显示“已开启”但空调未响应的情况。在软件逻辑中增加“执行反馈”机制：调用API后若返回成功，视为操作成功；若连续三次失败，触发告警通知运维人员检查。
多平台兼容与扩展性：若企业未来计划引入Home Assistant等开源家庭助理，可参考类似的空调集成思路。目前的方案侧重于HTTP通用接口集成，如果企业需要更高频的状态轮询，可以选用WebSocket接口订阅设备事件。
6 开发实施
后端团队封装一个独立的YoYoService类，统一处理签名、请求重试、超时控制等逻辑。前端页面无需直接暴露AppSecret，所有请求经由业务后端转发至芯步API，保障密钥安全。引入消息队列（如RabbitMQ或Kafka）处理高频定时任务，同时在设备端预留一定的红外发射功率余量，以适应办公环境的灰尘累积或遮挡情况，确保长期运行稳定。通过本方案的实施，企业可在现有软件系统内以较低成本实现全办公空间空调的智能化升级。