舞蹈室空调控制：怎样将万能空调遥控器接入到自己的项目中_解决方案

CATALOG

舞蹈室的空调控制有几个典型痛点：空调数量多但品牌杂，普通万能遥控器无法接入管理系统，管理员每天要跑好几个房间开关机。芯步的智能空调遥控器开放了HTTP接口，可以把这个硬件直接嵌入你自己的管理后台或小程序中。以下方案涵盖硬件选型、API对接、签名计算、场景实现等完整环节。

1. 背景与选型

在许多舞蹈室场景中，夏天需要长时间开启空调保持凉爽，冬天需要制热，但如果空调一直开着会导致极大的电力浪费。传统方案是人工手动使用遥控器开关，不仅效率低下，且容易出现“人走未关”的情况。为了实现智能化控制，我们需要将万能空调遥控器接入到自己的项目（如微信公众号、小程序、PC管理后台或APP）中。

推荐硬件：芯步 - 智能空调遥控器这款设备通过WiFi联网，支持远程控制市面上90%以上带红外接收功能的空调品牌。其核心优势在于免费开放HTTP接口，意味着只要你懂一点编程（如JavaScript、Python、Java等），就可以通过代码直接控制舞蹈室的空调。

2. 方案逻辑架构

本方案采用云云对接或局域网直连的模式：

用户端：学员/管理员通过微信小程序或后台网页点击“开启空调”。
业务服务器：你的自有服务器接收到指令。
芯步云：你的服务器调用芯步的开放API。
硬件设备：智能空调遥控器收到云端指令，发射红外信号控制空调。

由于芯步的设备支持 HTTP API 和 局域网本地控制（私有化部署），如果你比较看重响应速度或数据安全，整个流程也可以在舞蹈室的局域网内完成，不经过外网。

3. 准备工作：设备配网与管理后台设置

在写代码之前，需要先完成硬件的初始化和开发密钥的获取。

3.1 硬件配网

通电：将智能空调遥控器接通Type-C或USB电源，确保遥控器放置在舞蹈室空调附近，距离8米内且中间无遮挡。
连接WiFi
- 下载“芯步”小程序或登录PC物联控制台。
- 设备启动后通常处于热点模式（指示灯闪烁）。
- 通过小程序为设备配置舞蹈室的2.4G WiFi网络（注意：大部分IoT设备不支持5G WiFi）。

3.2 获取开发凭证

登录芯步开放平台，进入“工作台” -> “物联网控制台” -> “开发设置”：

AppID：应用的唯一标识。
AppSecret：接口密钥（用于签名计算，请勿泄露）。
调试模式：在开发阶段，可以临时开启“调试模式”来暂时忽略签名校验，方便快速测试功能。

4. 接口对接开发详解

这是整个项目最核心的技术环节。你需要根据自己的项目后端语言（Node.js、Python、Go、PHP等）调用HTTP接口。

4.1 鉴权机制与签名计算

为了防止接口被恶意调用，芯步的接口通常要求携带签名（Sign）。如果不开启调试模式，就需要按照如下规则构造请求头：

Header 参数示例：

签名计算方法：通常是将 AppSecret、ts（时间戳）、以及其他参数按照ASCII码升序排序拼接后，进行MD5加密。

对于不太熟悉后端的开发者：在开发测试阶段，直接在“开发设置”中开启“调试模式”，此时系统不检查 sign 和 ts，可以通过Postman直接发送命令。

4.2 核心控制代码示例（伪代码/JavaScript）

假设你需要在你的后端服务中发送“制冷、24度、自动风”的指令。

接口地址https://api.yoyoiot.com/ordercontrol请求方法：POST

// 示例:使用 axios 在 Node.js 环境中控制空调
const axios = require('axios');

async function controlAirConditioner(deviceId, command) {
  const url = 'https://api.yoyoiot.com/ordercontrol';
  
  // 芯步通常要求携带的Header
  const headers = {
    'AppID': 'YOUR_APP_ID',
    'ts': Math.floor(Date.now() / 1000),
    // sign: 计算出的签名，调试模式下可忽略
  };

// 构造控制指令
  // 这里假设你需要控制空调的具体参数，具体字段请参考《智能空调遥控器产品手册》
  const body = {
    "device_id": deviceId,      // 你要控制的那个遥控器的ID
    "command": {
      "power": "on",            // 开机:on，关机:off
      "mode": "cool",          // 模式:cool(制冷), heat(制热), auto(自动), fan(送风)
      "temp": 24,              // 温度:16-30度
      "wind_speed": "auto"     // 风速:low, mid, high, auto
    }
  };

try {
    const response = await axios.post(url, body, { headers });
    console.log('控制成功', response.data);
    return response.data;
  } catch (error) {
    console.error('控制失败', error.response.data);
  }
}

// 调用函数:控制舞蹈室1号空调开启并设为24度
controlAirConditioner('设备ID_123456', { power: 'on', temp: 24 });

4.3 获取设备状态

为了在管理后台看到“舞蹈室空调是否真的开了”，可以调用获取设备状态的接口。接口GET https://api.yoyoiot.com/orderstatus/{device_id}

通过轮询这个接口，你可以知道红外指令是否发送成功，但由于红外是单向通信的，部分情况下可能需要依赖空调伴侣内部的传感器（如电流检测）来判断空调是否真的启动了。

5. 高级功能与场景集成

仅仅能用API开关是不够的，结合舞蹈室的实际运营需求，可以做更智能的联动。

5.1 定时任务与预约

如果不希望写代码去实现定时器，可以利用芯步平台自带的云定时功能，或者在你的系统中设置定时触发器。

场景：管理员通过后台设置，周一至周五 18:00-21:00（晚间舞蹈课高峰）自动开启空调，22:00 自动关闭所有空调。
接口实现：调用 创建定时任务 接口，设定 cron 表达式。

5.2 温度自适应闭环

舞蹈室在进行剧烈运动（如街舞、热舞）时，体感温度会比平时高。

逻辑：对接一个温湿度传感器或者利用芯步的环境监测设备。
实现：当环境温度 > 26°C 且红外检测到空调关机状态 -> 自动开机；当温度 < 20°C（制热模式）-> 自动关机或调低风速。

5.3 微信/钉钉机器人通知

场景：为了避免老师忘记关空调，可以在每天晚上 22:30 执行一次“关机”指令，并通过接口调用企业微信机器人或钉钉机器人，发送通知：“【安防通知】B101舞蹈室空调已自动关闭，当前电量消耗低。”

6. 项目实施步骤清单

为了方便执行，这里梳理一个简易的落地时间表：

采购与测试：购买芯步智能空调遥控器，在Demo环境中通过官方调试工具测试红外码库是否匹配舞蹈室的空调品牌（如格力、美的、大金等）。
内网穿透/服务器配置：确保你的业务服务器能够访问公网API（如果是纯局域网方案则无需）。
核心对接：编写后端服务的SDK封装（约1-2小时），实现签名算法和开关机指令。
前端交互：在现有的“舞蹈室管理系统”或“学员小程序”中，增加一个“空调控制”选项卡。做权限隔离：店长可看全店，普通老师只看自己分配的教室。
部署与布线：将设备贴在墙壁或吊顶内，注意供电线（USB线）的隐蔽性。

7. 常见问题与避坑指南

红外遮挡问题：智能空调遥控器必须正对空调的接收面板，中间不要有遮挡（如吊灯、金属架）。如果遥控器放在弱电箱里，是无法控制空调的。
状态同步问题：由于红外遥控是单向的，如果学员手动拿了原装遥控器按了关机，你的后台可能还显示“开机”状态。
- 解决方案：可以采用“倒计时自动同步”逻辑，或者如果购买了支持电量检测的版本，通过功率判断空转状态。
网络稳定性：舞蹈室若偶尔有断电断网，设备需支持重连机制。芯步的设备支持设定5组WiFi，将路由器的2.4G信号强度调至最大。

8. 总结

通过将芯步的万能空调遥控器接入项目，舞蹈室的空调管理可以实现自动化和数据化。该方案的交付周期短（通常1-3天即可完成API对接），成本低廉（设备单价适中，无年费）。学员可以通过扫码预约课程时的页面顺便开空调，管理员也不用每天跑腿去关空调，完美解决了舞蹈室运营中的能耗管理痛点。