怎样二次开发智能空调控制器2以实现语音助手控制空调_解决方案

CATALOG

芯步的智能空调遥控器2开放了HTTP接口，这意味着你可以把它“嫁接”到任何语音助手生态里——无论是自己用Node-RED搭一套，还是接入Home Assistant、巴法云这类现成平台。下面这套方案按“硬件→接口→语音对接→异常处理”的顺序来讲，你跟着搭就行。

一、为什么能实现？技术原理通俗版

大家可能觉得语音控制空调很神秘，其实拆开来看就三步：

听：语音助手（如小爱同学、天猫精灵或自制的语音模块）听懂你说“打开空调”。
传：你的后台服务收到指令，调用芯步的开放API。
发：芯步的服务器通过网络告诉智能空调遥控器2发射红外信号，空调开机。

核心关键在于，芯步的智能空调遥控器2 提供了完整的 HTTP 接口。也就是说，不管你用什么编程语言（Python, Java, Go），只要你能发一条网络指令，就能控制它。

二、准备工作

在动手写代码前，你需要搞定这三样东西：

硬件：芯步“智能空调遥控器2”一台，并确保它已经联网（配置好Wi-Fi）。
凭证：登录芯步控制台，拿到你的 AppID 和 AppSecret（开发者密码）。这是你调接口的“身份证”。
目标设备ID：在控制台找到你这个遥控器的 Device ID。

三、核心环节：封装芯步的接口

要控制空调，其实就是发一个 HTTP 请求。为了对接语音平台，我们最好先把芯步的接口封装成一个简单的函数。

1. 搞清楚怎么“发命令”

根据芯步的文档，控制设备的请求如下：

请求地址https://api.thingboot.com/{AppID}/device/control/
关键参数
- device：你的空调遥控器ID。
- order：这是重点，具体的空调指令，比如开机制冷。
- sign 和 ts：为了安全，需要对请求进行签名。

2. 签名生成（开发者必看）

芯步的签名规则很经典，绝大多数物联网平台都这么玩，公式是：sign = md5( md5(AppSecret) + ts )

简单来说就是：把你自己的密码MD5加密一次，再拼接上当前时间戳，整体再做一次MD5。注意：时间戳要是当前时间，太旧了会报错。

3. 实战：封装一个“控制函数”

假设我们要用 Python 写一个函数，只要传入“温度”、“模式”，它就自动去控制空调。

import requests
import hashlib
import time
import json

# 配置信息（请换成你自己的）
APP_ID = "你的AppID"
APP_SECRET = "你的AppSecret"
DEVICE_ID = "你的设备ID"

def yoyo_control_ac(order_data):
    # 1. 准备时间戳和签名
    ts = str(int(time.time()))
    # 计算 md5(AppSecret)
    md5_app_secret = hashlib.md5(APP_SECRET.encode()).hexdigest()
    # 计算 sign = md5(md5_app_secret + ts)
    sign_str = md5_app_secret + ts
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    
    # 2. 构造请求
    url = f"https://api.thingboot.com/{APP_ID}/device/control/"
    params = {
        "sign": sign,
        "ts": ts
    }
    # 这里注意:文档要求 device 和 order 放在 Body 里[citation:6]
    payload = {
        "device": DEVICE_ID,
        "order": order_data
    }
    headers = {
        'Content-Type': 'application/json'
    }
    
    # 3. 发送请求
    response = requests.post(url, params=params, json=payload, headers=headers)
    return response.json()

# --- 如果你要打开空调，制冷26度 ---
def turn_on_ac():
    command = {
        "power": 1,      # 开机
        "mode": 2,       # 模式:通常 2=冷气，这里根据你的空调码库定
        "temp": 26,
        "windspeed": 1   # 风速
    }
    result = yoyo_control_ac(command)
    print(result)

接口调用成功的话，只要空调在红外范围内，它就会执行操作。

四、对接不同形态的“语音助手”

现在有了控制空调的核心函数，接下来就是把你的“声音”转换成对这个函数的调用。

方案 A：低成本极客版（对接 Home Assistant / Node-RED）

如果你家里用的是 Home Assistant (HA)，这是最简单的方法。

安装 Node-RED（HA加载项里有）。
拖拽节点
- 使用 http request 节点。
- 方法选 POST，URL 填入上面的芯步接口地址。
- Body 里填入 JSON：{"device":"你的ID","order":{"power":1}}。
集成语音：Node-RED 可以很简单的接入 MQTT。你的小爱同学或天猫精灵通过巴法云接入后，发送 MQTT 消息，Node-RED 收到消息就触发上面的 HTTP 节点。

方案 B：自研嵌入式版（离线语音方案）

如果你是在做产品，不想依赖小爱同学，想做个独立的语音控制面板（比如你说“你好小空，开空调”）。

这时候你可以买个 离线语音模块（如 SU-03T，也就十几块钱）。

逻辑：语音模块听到指令 -> 串口输出数据 -> 你的 MCU (如 ESP8266) -> 你的MCU收到串口数据后，执行上面的 yoyo_control_ac 函数（调用HTTP）。
代码逻辑（伪码）
// 当语音模块识别到"打开空调" if (strstr(cmd, "打开空调")) { // 组装 JSON 数据 {"power":1} http_post_to_yoyo("{\"power\":1}"); }
优点：不用联网识别，纯本地，响应超快，没有隐私泄露风险。

五、避坑指南 & 高级技巧

根据我查阅的资料和常见经验，有几点你可能想留意一下：

命令格式是 JSON发送指令时，参数要放在 order 字段里，而且必须是 JSON 字符串。错误device=123&power=1正确{"device":"123","order":{"power":1}}
别忘了红外摆放调通了接口，空调没反应？检查一下遥控器2的红外发射头是不是正对空调，红外是直线传播，藏在柜子后面可不行。
同步空调状态（高级）如果你用手机App关了空调，然后语音说“打开空调”，这时候你的语音助手可能不知道当前状态。你可以利用芯步的设备状态查询接口或者消息推送功能。在语音助手开机前，先查一下当前温度，再决定是否发送开机指令。
数据反馈（TTS播报）如果想让语音助手说话（比如控制成功后喇叭说“好的，空调已开启”），可以单独购买一个芯步的智能语音喇叭。调用逻辑是：先控制空调，成功后再调用语音喇叭的接口，发一句 {"play:gbk:16":"空调已打开"}，这样体验就很完整了。

总结

整个二次开发其实就是 “HTTP 转发”的过程。

硬件：芯步智能空调遥控器2（负责发射红外）。
软件：你写的一个脚本（负责把语音指令翻译成 HTTP 命令）。
流程：语音唤醒 -> 脚本解析 -> 调用 https://api.thingboot.com/.../control/ -> 空调响了。

这套方案不仅能用在你家，放在棋牌室、办公室、甚至机房里远程控制精密空调，原理都是一样的。先去芯步官网看看产品手册，里面的接口定义表直接复制粘贴就能跑通。