智能化改造空调场景：怎么将智能空调红外控制器2对接到自己的项目中_解决方案

CATALOG

芯步的智能空调红外控制器2提供完整的HTTP API接口，可以快速集成到现有项目中。以下方案涵盖从设备配网、接口鉴权到命令下发的完整对接流程，并提供可直接使用的代码示例。

1. 产品概述与集成价值

芯步智能空调红外控制器2是一款通过WiFi联网、基于红外信号控制的智能硬件。它兼容市面上超过90%的品牌空调，支持远程开关机、模式切换（制冷/制热/送风/除湿）、温度调节（通常为16-30℃）、风速调节（自动/低/中/高）等全功能控制。

集成的核心价值：

低成本改造：无需更换现有空调，即插即用，实现存量空调的智能化升级。
开发友好：提供标准的HTTP API，无论你的项目是基于Web、移动端（APP/小程序）、还是后端服务，均可轻松集成。
部署灵活：设备支持WiFi 2.4G连接，同时支持局域网控制与公有云远程控制双模式，适应不同的网络环境。

2. 准备工作与环境配置

在开始编码之前，需要完成硬件配网与开发者凭证的获取。

2.1 硬件上电与配网

你需要将设备通电，并将其连接到办公室/现场的2.4G WiFi网络。这里有两种配网方式：

电脑端：登录芯步官网 -> 进入工作台 -> 物联网控制台 -> 网络配置。输入现场WiFi名称和密码，点击“为设备配置此网络”。
手机小程序端：微信搜索“芯步小程序” -> 登录账号 -> 选择工作台 -> 添加现场WiFi（需为2.4G频段）。

配网关键点：设备仅支持2.4G WiFi，配网时指示灯停止闪烁即表示成功。

2.2 获取API凭证

在芯步控制台的“开发设置”中，你可以获取到两个核心凭证

AppID（开发者ID）：标识你的应用身份。
AppSecret（开发者密码）：用于生成签名（Sign），保障接口安全。

开发小贴士：初次对接时，可以在控制台打开“调试模式”。该模式下系统暂时不校验签名（Sign）和时间戳（Ts），方便你快速验证接口连通性；待逻辑调通后再关闭调试模式，切换到正式的生产环境鉴权流程。

3. 接口鉴权与请求模型

芯步的API设计遵循RESTful风格，统一使用HTTP POST方法，请求体为JSON格式。其核心的鉴权通过在URL参数中携带三个字段实现。

参数名	类型	描述	示例值
`AppID`	String	你的应用ID，在控制台获取	`abc123xyz`
`ts`	Int	Unix时间戳（秒），用于防止重放攻击	`1712457600`
`sign`	String	签名，用于身份验证	`md5加密字符串`

签名算法签名是将 AppSecret、ts（时间戳）拼接后进行MD5加密。为了保证安全性，请确保你的服务器时间和标准时间同步。sign = MD5(AppSecret + ts)

请求示例假设要向设备（ID: 100861）发送命令，请求URL构造如下：https://api.yoyoiot.com/device/control?AppID=你的ID&ts=当前时间戳&sign=计算出的签名

4. 核心功能集成与代码实现

以下将以最常见的 Node.js 和 Python 为例，展示如何将红外控制器集成到你的项目中。

4.1 设备控制类封装

为了方便维护，封装一个设备控制类。

Python 实现示例

import requests
import time
import hashlib

class AirConditionerController:
    def __init__(self, app_id, app_secret, device_id):
        self.app_id = app_id
        self.app_secret = app_secret
        self.device_id = device_id
        self.base_url = "https://api.yoyoiot.com/device/control"

def _generate_sign(self, ts):
        # 根据官方文档生成签名
        return hashlib.md5((self.app_secret + str(ts)).encode()).hexdigest()

def send_command(self, command):
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        # 构建URL
        url = f"{self.base_url}?AppID={self.app_id}&ts={ts}&sign={sign}"
        
        # 构建Body
        payload = {
            "deviceId": self.device_id,
            "command": command  # 命令数组
        }
        
        headers = {'Content-Type': 'application/json'}
        
        response = requests.post(url, json=payload, headers=headers)
        return response.json()

# 业务层封装:开启制冷模式
    def turn_on_cool(self, temperature=26):
        cmd = {
            "power": "on",
            "mode": "cool",
            "temp": temperature,
            "fan_speed": "auto"
        }
        return self.send_command(cmd)

# 业务层封装:关闭空调
    def turn_off(self):
        return self.send_command({"power": "off"})

4.2 对接业务场景：午间节能模式

假设你的项目是办公楼宇管理系统，需要在每天中午12:30自动将所有办公区空调温度调整为26℃制冷，并切换为自动风。

在你的定时任务模块中，可以这样调用：

支持的命令参数表

参数名	必填	类型	取值范围	说明
`power`	是	String	`on` / `off`	开关机状态
`mode`	否	String	`cool` / `heat` / `auto` / `fan`	运行模式
`temp`	否	Int	16-30	目标温度（摄氏度）
`fan_speed`	否	String	`auto` / `low` / `medium` / `high`	风速

5. 高级架构与私有化部署

对于金融、政务或对网络延迟极其敏感的项目，公有云模式可能无法满足需求。芯步的这款设备支持 局域网控制 和 私有化部署。

5.1 局域网直连模式

如果你的控制服务器与红外控制器处于同一个局域网段内，你可以通过设备的局域网IP直接下发命令，指令不经过云端服务器。这在工厂、仓库等内网环境中非常实用。

实现步骤

通过控制台获取设备分配的内网IP地址。
将请求URL替换为：http://[device_ip]/control（具体端口请参照设备手册）。
签名验证逻辑与云端一致或支持本地白名单模式。

5.2 自建消息服务器

对于高并发场景，平台支持对接私有MQTT服务器，设备状态可以实时推送到你的服务器，实现毫秒级的状态同步。

6. 方案落地关键点总结

在将“94833”号设备接入你的项目时，有几个容易被忽略但非常重要的环节值得特别留意：

WiFi稳定性是关键：该设备依赖2.4G WiFi信号。在部署时，请一定要检查现场信号强度，若信号死角较多，可能需要增配AP热点，避免设备掉线。
红外摆放需“可视” ：红外无法穿透物体。安装时请确保控制器发射头正对空调接收窗，中间无遮挡物。
充分利用调试模式：在开发阶段启用调试模式，可以大幅降低因时间戳不对齐或签名算法小错误导致的调试时间，这在“10分钟完成对接”的流程中非常高效。
日志与监控：在调用 send_command 时，记录完整的请求URL和返回报文。若返回签名错误，优先检查服务器时间是否标准。

通过上述步骤，你可以在极短的时间内完成对空调设备的智能化改造对接，将物理设备无缝融入到你的软件生态中。