智能化改造空调场景：如何把智能空调遥控器2接入到项目中_解决方案

CATALOG

芯步的智能空调遥控器2通过开放HTTP接口，可快速接入各类软件项目。以下方案涵盖设备配网、接口对接、代码实现到场景的完整流程。

解决方案：基于芯步开放接口的空调智能化改造

1. 背景与目标

在许多办公、酒店及家居场景中，传统空调存在无法远程控制、能耗浪费、管理不便等问题。本方案的目标是通过接入芯步智能空调遥控器2，利用其开放的HTTP接口，将普通壁挂式/柜式空调（支持红外遥控）无缝对接到现有的管理系统（如APP、Web管理后台、企业微信/钉钉应用）中。

改造成本低：无需更换昂贵的新型空调，即装即用，保留原空调物理遥控功能。该产品支持市面上90%以上的红外空调品牌。

2. 核心产品能力

智能空调遥控器2具备以下核心特性，是集成的关键基础：

联网方式：支持2.4G WiFi直连，无需额外网关，支持5组WiFi备选，保障连接稳定性。
控制能力：支持通过红外指令精准控制空调的开关机、模式（制冷/制热/送风/除湿）、温度（16-30℃）、风速（自动/低/中/高）及扫风。
接口开放度：提供全开放HTTP API，支持任何支持HTTP请求的编程语言（Java, Python, PHP, Node.js, Go等）调用。
部署灵活性：支持公有云调用，也支持纯局域网本地化控制及私有化部署，保障数据安全与控制时延。

3. 整体设计

整个智能化改造逻辑分为四层：

设备层：智能空调遥控器2 + 目标空调。遥控器通过红外控制空调，通过WiFi联网。
接入层（芯步云）：设备保持长连接，接收来自HTTP接口的指令，转换为红外信号下发。
业务层（您的服务器）：您的业务系统通过调用芯步开放接口，下发控制指令，并处理业务逻辑（如权限校验、定时任务、日志记录）。
用户端：微信小程序、H5网页、PC管理后台等。

4. 实施步骤与接口集成详解

4.1 环境准备

注册与登录：访问芯步官网注册企业/个人账号。
获取凭证：登录控制台 -> “物联网控制台” -> “开发设置”。获取AppID（应用ID），并设置AppSecret（开发者密码）。注：测试初期可开启“调试模式”暂时忽略签名校验，以便快速验证功能。
设备配网
- 将智能空调遥控器2通电。
- 方式A（电脑端）：在物联网控制台的“网络配置”中添加现场2.4G WiFi的SSID和密码，点击“为设备配置此网络”，并利用手机热点辅助完成配网。
- 方式B（小程序）：使用“芯步小程序”扫码，按照指引为设备配网。
- 配网成功后，设备指示灯常亮，在控制台“设备列表”中可看到该设备状态变为“在线”及其唯一DeviceID。

4.2 接口调用核心逻辑

接口地址结构（以控制设备为例）：POST https://api.thingboot.com/{AppID}/device/control?sign={sign}&ts={ts}

请求头（Header）通常需要 Content-Type: application/json。

鉴权机制（签名计算）在生产环境下，需计算sign。虽然官方未在片段中给出具体算法公式，但标准RESTful API的通用逻辑如下（仅供参考，实际请查阅官方《产品手册》）：sign = md5(AppID + AppSecret + ts)其中ts为Unix时间戳（秒），用于防重放攻击。服务器收到请求后，会用同样的算法计算一次并对比，同时校验时间戳是否在有效窗口期内（如5分钟）。

请求体（Body）此接口为POST请求，参数通常包含device和order。

参数	类型	描述	示例
device	String	在控制台获取的设备唯一ID	`"12345678"`
order	JSON String	具体的空调控制指令	`{"pow":"1", "mode":"cool", "temp":"24"}`

4.3 业务代码示例（伪代码/思路）

由于官方手册强调接口简单，以下展示如何封装一个通用的控制函数：

Python 后端示例 (使用 requests 库)

import requests
import time
import hashlib

class YoYoAirconController:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control"

def _generate_sign(self, ts):
        # 假设的签名算法，具体请参照芯步官方文档
        raw = f"{self.app_id}{self.app_secret}{ts}"
        return hashlib.md5(raw.encode()).hexdigest()

def control_ac(self, device_id, command):
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        
        payload = {
            "device": device_id,
            "order": command  # command 是一个 dict，例如 {"pow":"1", "temp":"26"}
        }
        
        response = requests.post(url, json=payload)
        return response.json()

# 调用示例:开启办公室1号空调，设置为制冷26度
controller = YoYoAirconController("your_AppID", "your_AppSecret")
command_json = {
    "pow": "1",      # 1开机, 0关机
    "mode": "cool",  # cool制冷, heat制热, fan送风, auto自动
    "temp": "26",    # 温度
    "wspd": "2"      # 风速: 0自动, 1低, 2中, 3高
}
result = controller.control_ac("device_123456", command_json)
print(result)

4.4 指令集对照表（基于通用空调指令）

为了便于开发，提取常用指令映射

功能	JSON 指令示例	说明
开机	`{"pow":"1"}`	-
关机	`{"pow":"0"}`	-
制冷模式	`{"mode":"cool", "temp":"24", "wspd":"2"}`	设置24度，中风
制热模式	`{"mode":"heat", "temp":"28", "wspd":"3"}`	设置28度，高风
风速调节	`{"wspd":"1"}`	低风
温度调节	`{"temp":"25"}`	仅调整温度，其他状态不变
扫风开关	`{"air":"1"}`	`1`开启扫风，`0`关闭

5. 业务场景解决方案落地

第一种场景：办公/学校节假日节能管理

痛点：下班后空调忘关，导致巨大电费浪费。
方案：您的OA系统在每晚20:00通过定时任务（Crontab或Scheduler）调用上述API，遍历所有会议室和办公室的DeviceID，下发关机指令{"pow":"0"}。
升级：接入温湿度传感器，当室内温度低于10℃且空调为制热模式未关闭时，自动发送短信提醒管理员或远程关机。

第二种场景：共享空间/酒店预授权控制

痛点：客人退房后空调未关，或者客人入住前房间过冷/过热。
方案
1. 入住前：用户在小程序下单成功，系统自动调用接口，设置空调为制冷22℃（预设温度），提升入住体验。
2. 退房后：用户点击退房，业务系统立即调用接口关闭空调，避免资源浪费。
3. 能耗统计：结合芯步接口的电量统计功能（如涉及智能插座），计算每间房的空调用电成本。

第三种场景：智慧农业/养殖场恒温控制

痛点：鸡舍或温室大棚需要恒温，传统空调手动调节滞后。
方案：您的服务器程序轮询环境传感器。若检测到温度>30℃，自动向特定DeviceID发送制冷指令；若温度<15℃，发送制热指令。利用HTTP接口的局域网支持特性，此过程无需经过外网，即使断网（本地网络通）也可自动控制。

6. 高级部署与优化

局域网控制（私有化）如果您的项目运行在工厂或实验室内部，且对公网带宽依赖低，可以开启私有化模式。设备会通过 mDNS 或配置的固定IP在局域网广播，您的后端服务器直接请求设备的本地IP地址，实现毫秒级响应，完全脱离外网。
调试技巧芯步控制台提供设备调试界面。在界面上点击按钮（如“开机”），查看浏览器开发者工具（F12）中的Network请求，可以看到实际发送的HTTP报文格式，直接复制该格式用于您的代码开发，是最高效的对接方式。
设备分组管理对于大型项目（如整栋写字楼），不要仅用DeviceID循环控制。可以使用“控制台分组”功能，将3楼的10台空调绑定为一个“组ID”，通过接口向组下发指令，实现一键全开/全关。

7. 总结

通过将芯步智能空调遥控器2作为“红外转WiFi”的桥梁，结合其标准化的HTTP接口，开发者可以在10分钟内完成从代码编写到控制空调的闭环。无论是简单的定时开关，还是复杂的基于大数据的恒温策略，都能通过本文所述的API集成方式稳定实现。该方案不仅保护了客户的旧空调资产，且极大地提升了管理效率与智能化水平。