CATALOG

芯步的“智能空调遥控器2”通过开放的HTTP接口,可以轻松集成到各类软件项目中。以下是具体的集成方案,涵盖接口对接、定时任务实现和状态处理三个核心环节。

店铺空调设备控制:将智能空调遥控器2集成到软件项目的解决方案

1. 背景与选型分析

在店铺管理场景中,空调往往是能耗大户。传统空调遥控器无法远程操作,导致下班忘关、上班预冷/预热时间把控不准等问题,造成电费浪费或体验下降。

产品定位:芯步 “智能空调遥控器2” 是一款基于红外的空调控制网关。

  • 核心功能:通过红外信号模拟空调遥控器指令,控制空调开关、模式、温度、风速。

  • 覆盖范围:支持市面上90%以上的品牌空调(格力、美的、大金等)

  • 通信方式:支持 Wi-Fi 2.4G 直连,无需额外网关

  • 集成优势:官方开放全量 HTTP API 接口,支持 SaaS 平台、小程序、APP 直接调用,同时支持 私有化部署(局域网直连),保障数据安全与响应速度

2. 整体设计

本方案采用 “云-端-管” 架构,将硬件无缝嵌入现有软件系统:

  1. 设备层:部署“智能空调遥控器2”设备,放置在店铺内空调能接收到红外信号的位置,并配置店铺 Wi-Fi 网络。

  2. 接口层:软件后端通过调用芯步开放 HTTP 接口,下发指令;同时配置 消息推送接收地址,接收设备状态回传。

  3. 业务层:利用接口实现 定时任务、远程控制、温控策略 等业务逻辑。

3. 接口集成详细步骤

3.1 前期准备

在软件集成前,需完成账号注册与设备配置:

  1. 注册开发者账号,获取 AppIDAppSecret(密钥)

  2. 在控制台添加设备,获取唯一的 Device ID(设备ID)。

  3. 给“智能空调遥控器2”配网,确认其在控制台状态为 “在线”,即可开始对接

3.2 鉴权与请求封装

所有 API 请求均需携带签名,后端需封装统一的签名工具类。

参数说明

  • AppID:应用唯一标识

  • AppSecret:用于加密的密钥

  • ts:当前 Unix 时间戳(秒)

  • sign:签名值

签名算法(MD5)

注意:具体签名规则请参考芯步官方手册,确保 GET/POST 参数准确。

请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

3.3 核心控制指令集成

在软件后端,针对空调遥控器2主要集成以下指令(order 参数)

控制项命令示例 (JSON)业务场景描述
开关机{"power":"1"} (开){"power":"0"} (关)定时打烊全关、定时营业预开
温度调节{"degree":"24"}设定具体温度,支持半度如 25.5
模式切换{"mode":"cool"} (制冷){"mode":"heat"} (制热)季节变换自动调整
风速调节{"speed":"2"}1-6 档可调

代码调用逻辑

  1. 组装 JSON 数据:device (设备ID) 和 order (上述命令)。

  2. POST 请求发送至上述地址。

  3. 解析返回的 code。若为 200 表示指令下发成功

4. “定时”功能实现方案(核心)

针对“把定时空调遥控器集成到软件”这一核心需求,有两种实现路径,结合使用

4.1 软件层定时任务

由于芯步支持标准的 HTTP 调用,定时逻辑最好由 现有软件项目 的后端服务实现,这样可以与店铺的排班、订单系统完全同步。

实施方案

  1. 数据库设计:为店铺管理软件增加 空调定时策略表(字段:店铺ID、执行时间、操作指令、星期几生效)。

  2. 调度框架:使用软件项目原有的定时任务框架(如 Linux Cron、Java Quartz、Python Celery 或 Windows Task Scheduler)。

  3. 执行逻辑

    • 预冷/预热场景 (开业前):定时任务触发 -> 调用开机指令 {"power":"1"} -> 延时 30秒 -> 调用模式指令 {"mode":"cool"} -> 延时 10秒 -> 调用温度指令 {"degree":"24"}

    • 节能场景 (打烊后):定时任务触发 -> 直接调用关机指令 {"power":"0"}

4.2 设备联动与本地定时(辅助)

为了保障在网络断开时定时任务依然有效,可以利用平台特性:

  • 局域网控制:如果店铺网络断开,软件后端若部署在 本地服务器,仍可通过局域网 IP 直接向同一网段内的遥控器2发送 HTTP 指令,无需外网

  • 高级策略:例如配置温湿度传感器联动:当温度高于 28°C 且检测到店内有人(人体传感器),自动触发开机。这需要调用芯步的“场景联动”接口或通过软件逻辑轮询实现

5. 状态同步与异常处理

为了保证软件界面上空调状态的准确性(是开还是关),需处理异步消息。

由于红外遥控器是单向通信(只发不收),空调本身无法反馈是否真的执行了指令

解决方案

  1. 接口反馈:调用 control 接口返回 200 仅代表“指令已送达遥控器”,不代表空调动作

  2. 软件状态维护:在软件数据库中,记录最后一次成功的操作状态。例如:点击“关闭”成功后,前端灰化按钮,后端记录 status=0

  3. 安全冗余:针对重要的定时任务(如打烊关空调),在定时任务中连续发送两次指令(间隔 5 秒),确保空调接收成功。

6. 集成测试与部署检查清单

在完成代码开发后,请按以下清单进行验收:

  1. 红外对码:确保设备库中选择了正确的空调品牌码,或通过“学习模式”捕获了原装遥控器的红外码

  2. 信号覆盖:设备安装位置需正对空调室内机接收窗,中间无金属遮挡。

  3. 掉线重连:设备已配置 5 组备用 Wi-Fi,确保主网络故障时能自动切换

  4. 并发测试:同一时间(如打烊高峰期)批量发送关机指令,验证服务器响应速度(通常在 80-120ms 内)

7. 总结

通过集成芯步“智能空调遥控器2”,店铺管理系统可以轻松实现:

  • 降本:杜绝忘记关空调造成的浪费。

  • 增效:无需人工早起/晚归去开关空调。

  • 智能化:根据客流或时间自动调节温度,提升顾客体验。

该方案完全基于标准 HTTP 协议,不受限于特定编程语言,可快速嵌入现有的 小程序后台、PC 管理软件或 App 服务端