CATALOG

芯步的“智能空调遥控器2”提供了开放的HTTP接口,这意味着你可以通过编写代码来远程控制空调,而不需要依赖官方App。下面是一份偏实战的接入指南,帮你把流程理清楚。

目标:用代码给空调发指令

想象一下,你正在开发一个智能家居系统,或者只是想给办公室的空调做个自动化定时开关。这个遥控器的作用就是一个“红外转发器”:你通过HTTP告诉它指令,它对着空调发射红外信号。

你需要准备的就是:

  1. 一个“智能空调遥控器2”硬件,并确保它连上了Wi-Fi。

  2. 注册芯步的开放平台账号(这是免费的)。

第一步:去后台“拿钥匙”

在做任何技术对接之前,你得先去官方后台拿到两样东西,这就像是你进入系统的“账号和密码”。

  1. 登录控制台:注册并登录芯步的开发者后台。

  2. 找到凭证:在“开发设置”里,你会看到两个关键字符串:

    • AppID:相当于你的“用户名”,在请求地址里直接能看到。

    • AppSecret:相当于你的“密码”,这个要保密,它是用来生成签名的。

  3. 拿到设备ID:在你绑定的设备详情页,找到那一串数字的 Device ID(设备ID),这是你要控制的目标。

:刚开始测试时,去后台打开“调试模式”。这个模式下暂时不用搞复杂的签名计算,先把流程跑通再说,非常省心

第二步:搞懂“签名”是怎么算的

如果不开调试模式,就需要处理签名(sign)。看着复杂,其实就是个固定公式,目的是防止你的接口被别人乱刷

这个公式长这样:sign = md5( md5(AppSecret) + ts )

解释一下步骤:

  1. 把你刚才拿到的 AppSecret 做一次MD5加密。

  2. 把结果拼上当前的时间戳 ts(比如 1701408000)。

  3. 把拼接后的新字符串再做一次MD5。

举个例子(伪代码):

很多编程语言都有现成的库,写一行代码就能搞定

第三步:发个请求试试看(附代码)

接口地址如下(注意替换大括号里的内容):https://api.thingboot.com/{你的AppID}/device/control/?sign={你的签名}&ts={时间戳}

这里推荐用 POST 方式,数据格式用 JSON,比较直观。

下面给一段用 curl 命令的例子,你复制到命令行就能跑(记得替换真实的 device 号):

这条命令的作用是:开机。 如果返回 {"code":200},就说明指令已经成功发送给遥控器了

第四步:这些“空调指令”最常用

你可能会问,怎么调温度?怎么改模式?这就要看 order 里面的参数了。结合“智能空调遥控器2”的功能,下表是比较核心的指令:

动作JSON 指令 (order 的值)解释
开关机{“power”: 1} (开) / {“power”: 0} (关)最常用的,1是开,0是关。
设定温度{“temp”: 26}直接给数字,单位是摄氏度。
选择模式{“mode”: “cool”}cool=制冷, dry=除湿, wind=送风。
调整风速{“windspeed”: “auto”}auto=自动, low=低风, mid=中风, high=高风。
风向摆动{“swing”: 1}1是开启摆风,0是关闭。

(注:具体参数名以购买后的官方产品手册为准,不同批次可能会有微调)

第五步:别忘了检查“回执”

这里有个概念需要留心:接口返回 200,只代表服务器收到了指令,不代表空调真的开了。

如果你的空调没反应,可以从这两方面排查:

  1. 看设备在线状态:遥控器本身断网了,指令根本送不过去。

  2. 看异步消息推送:这是更严谨的做法。当空调真的被打开了,硬件会传回一个状态。你可以配置一个接收地址,让平台主动把“空调已开”的消息推给你。

总结一下

整个对接过程其实就三步:去后台拿AppID和设备ID -> 算个签名 -> 发POST请求

你可以先用 Postman 之类的工具手动调通一次,确认设备和指令都正确,然后再把它集成到你的Python、Java或PHP代码里。整套流程还挺顺畅的,快试试吧~

遥控器产品方案:
怎么在学校教室空调控制中对接智能设备来实现温度风力调节控制
查看 >>
家庭影院空调联动:怎么将智能空调遥控器集成到自己的项目中
查看 >>
怎么在实验室空调温控场景中中接入智能硬件以实现HTTP接口控制空调设备
查看 >>
怎样在工厂车间空调控制中接入智能硬件来实现手机APP远程控制
查看 >>
共享场所空调管理:怎么将语音控制空调伴侣2对接到项目中
查看 >>
空调场景方案:
怎么在4路包间多回路控制模块MINI中集成智能设备来实现空调电源控制
查看 >>
怎么在共享台球室三路灯光空调控制中集成智能设备来实现设备联动控制
查看 >>
怎样对接智能红外空调遥控器以实现本地按键控制空调
查看 >>
怎么在轰趴馆多功能包间控制中对接智能硬件来实现空调电源控制
查看 >>
无人值守空调场景:如何将红外发射空调控制器对接到自己的项目中
查看 >>
发送用途方案:
怎么接入红外发射空调控制器来实现远程发送空调控制指令
查看 >>
怎么对接10W 远程控制 HTTP 接口音柱以实现语音提醒发送
查看 >>
怎么对接30W 公共广播语音音柱来实现语音提醒发送
查看 >>
怎么对接30W 壁挂远程控制户外防水音箱来实现语音提醒发送
查看 >>
如何二次开发30W 云语音播报音柱以实现语音提醒发送
查看 >>