店铺空调设备控制：怎么将万能空调遥控器接入到软件项目中_解决方案

CATALOG

芯步的智能空调遥控器本身就是通过开放HTTP接口来控制的，接入软件项目的核心就是调用它的标准API接口——先配网拿到设备ID，再构造签名发指令就行。下面我会从准备工作到代码实现，把整个流程串起来讲清楚。

一、这个“万能遥控器”能做什么？

首先，咱们得知道这个硬件是什么。

简单来说，这玩意就是一个能联网的、会发射红外信号的“小盒子”。你把它挂在墙上或者放在架子上，对着空调。它连上你店里的 WiFi 后，你的软件就可以通过互联网告诉它：“嘿，帮我把那台空调调到 26 度制冷！”它就会发出红外信号，空调就听话了。

核心优势：

免布线：只要有电（通常是 USB 或者插头供电），连上 WiFi 就能用。
兼容性强：覆盖市面上绝大多数品牌的空调，因为它可以“学习”原装遥控器的信号。
响应快：通过 HTTP 请求控制，点一下按钮空调就响，没有明显延迟。

二、准备工作：把硬件“激活”

在写代码之前，得先把物理设备接入网络。芯步的设备配网流程做得比较简化，跟着走就行。

注册与登录：去芯步官网注册一个开发者账号，登录进入“工作台”的控制台页面。
设备配网
- 给遥控器通电，指示灯通常会是慢闪状态，表示等待配网。
- 在芯步的小程序或电脑控制台里，找到“网络配置”，输入你店铺里的 2.4G WiFi 名称和密码。
- 需要注意的是，目前很多物联网设备暂不支持 5G 频段的 WiFi，确保你的 WiFi 是 2.4G 的，不然设备连不上。
获取凭证：配网成功后，在控制台的设备列表里，你会看到一个唯一的 设备ID。同时，在“开发设置”里，记下你的 AppID 和 AppSecret（密钥）。这就好比是你的软件账号密码和设备的门牌号。

三、核心对接逻辑：就是发个 HTTP 请求

芯步的方案最友好的地方就是它的 开放 HTTP 接口。不管你的后端是用 Java、Python、PHP，还是前端想直接发请求，甚至连小程序和 App 都能直接调。

接口地址示例（以官方文档为准）：https://api.yoyoiot.com/ordercontrol

你需要发送的数据结构（JSON 格式）：

四、手把手写代码（Python 示例）

很多刚接触物联网的朋友可能会觉得“签名”很麻烦，其实它就是把你手里的密钥和参数打乱组合一下，防止别人伪造请求控制你的空调。

这里我们用 Python 写一个简单的脚本，你也可以很轻松地转换成其他语言。

第一步：定义函数，生成签名

芯步的签名规则一般是：将参数按字典序排序，拼接上密钥，然后做 MD5 加密。

import requests
import time
import hashlib

# 配置你的账号信息
APP_ID = "YOUR_APP_ID"
APP_SECRET = "YOUR_APP_SECRET"
DEVICE_ID = "YOUR_DEVICE_ID"

def send_command(cmd_name, cmd_value):
    # 1. 准备公共参数
    timestamp = int(time.time())
    
    # 2. 准备你要发的具体指令，比如我要开机制冷25度
    # 不同产品的指令字段不同，这个具体要看芯步的《产品手册》
    # 假设空调遥控器的命令格式是这样的:
    params = {
        "app_id": APP_ID,
        "device_id": DEVICE_ID,
        "ts": timestamp,
        # 这里是业务参数，比如开关、模式、温度
        "power": cmd_name,   # "on" or "off"
        "mode": "cool",      # cool/heat/fan
        "temp": 25
    }
    
    # 3. 生成签名 (这是关键步骤)
    # 先把字典按key排序，拼接成字符串，最后加上AppSecret
    sorted_keys = sorted(params.keys())
    sign_str = ""
    for key in sorted_keys:
        sign_str += f"{key}={params[key]}&"
    sign_str += APP_SECRET
    
    # 进行MD5加密
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    params["sign"] = sign
    
    # 4. 发送请求
    url = "https://api.yoyoiot.com/ordercontrol"
    response = requests.post(url, json=params)
    
    print(response.json())
    return response.json()

# 调用一下试试看，把空调设为制冷25度开机
send_command("on", "cool")

简单解释一下这段代码在干嘛：它就是把“谁(AppID)、控制哪个设备(DeviceID)、在什么时间(ts)、要干嘛(power=on)”这几个信息打包，加上你的秘钥做成的防伪标识(sign)，一起发给芯步的服务器。服务器验证签名正确，就会把指令下发给你的遥控器设备。

五、软件项目中的实战场景

当你把这个接口封装好之后，在软件项目里就可以玩出很多花样了。

1. 店铺 Web 后台管理系统如果你是在做一个店铺的后台管理系统，可以在界面上画一个大大的空调图标，或者做一个“下班一键关空调”的按钮。

场景：店长晚上盘点完，点一下“关闭所有空调”。后端只需要循环调用每个设备ID的关机指令即可，不用挨个拿着遥控器去角落找空调。

2. 自动化联动（智能策略）结合传感器或定时任务。

定时任务：每天早上 8：55，系统自动发送开机指令，让店铺提前凉快起来；晚上 22：00，自动发送关机指令，防止员工忘记关造成浪费。
温控联动：如果你店里还有芯步的温湿度传感器，可以写一个定时脚本跑着。如果检测到“中午 12：00 且温度 > 30度”，自动触发“制冷模式”指令。

3. APP 或小程序在 APP 里集成这个逻辑，用户甚至不需要打开专门的智能家居 APP，在你的应用里就能控制周围的环境。这对于一些共享空间（比如自习室、共享茶室）特别有用，用户在小程序里点一下，座位旁边的空调就开了。

六、避坑指南与温馨提示

红外是“单向”的：这一点得提醒一下。遥控器发信号给空调，空调不会发信号回来。所以如果你的员工用原始遥控器把空调关了，你的软件后台是不知道的，状态可能还是“开机”。解决办法有两种：一是定时轮询同步状态，二是不做状态显示，只做控制按钮。
局域网与私有化：芯步是支持局域网控制的。如果你比较看重数据安全或者不想走外网，可以把设备配置成局域网模式，在代码里把请求 URL 改成设备内网的 IP 地址就行，甚至不需要互联网。
码库 vs 学习模式：大多数情况下，万能遥控器内置的码库就能搞定主流品牌，直接配对就行。如果遇到杂牌空调，芯步的设备通常支持“学习模式”。操作很简单：在软件里点一下“学习”按钮，用原装遥控器对着遥控器按一下，红外信号就被录进去了。

七、总结

总的来说，把芯步的万能空调遥控器接入软件项目，其实并不是在做硬件开发，而是在调用一个 Web API。

只要你走通这三步，整个项目就活了：

拿参数：注册平台，拿到 AppID、Secret 和设备 ID。
学签名：参照官方文档，把签名算法搞定。
发指令：根据《产品手册》里的指令集，在需要的地方调用 HTTP 请求。

希望这个思路能帮到你，祝你开发顺利，给店铺的空调装上“智慧大脑”。