CATALOG

民宿空调控制是刚需——客人抱怨调不明白空调、人走了空调还在吹、夏季电费爆表,这些问题一套好的对接方案就能解决。芯步的产品用HTTP接口就能调,门槛比想象中低。下面从设备选型到代码实现完整梳理一下。

一、 痛点与需求分析

在开始写代码之前,我们先明确一下民宿管理后台对接空调控制到底要解决什么问题。通常来说,民宿老板想要的无非是这三点:

  1. 远程抄表与控制:客人退房但空调没关,不用保洁跑过去,直接在后台点一下“关闭”就行,省电。

  2. 预设房间环境:客人线上预订后刚下飞机,前台帮他远程把空调打开,夏天制冷冬天送暖,进房间就是最舒服的温度,好评率会明显提升

  3. 定时与联动:比如设定“凌晨2点自动将全屋空调设为节能温度”,或者配合门磁实现“开窗关空调”。

要实现这些,我们需要使用芯步生态里的智能空调遥控器(红外控制,适用于老式挂机)或者智能插座/通断器(适用于直接断电)。

二、 解决方案架构

整个对接流程可以用一句话概括:你的服务器通过HTTP接口告诉芯步的云平台要控制哪个设备,芯步的云平台通过WiFi把指令推送到房间里的硬件,硬件执行命令。

核心优势:芯步的设备开放接口是HTTP协议的。这意味着不管你后端用的是Java、Python、PHP还是Node.js,甚至是你写一个简单的Shell脚本,都能轻松对接,不需要复杂的SDK,也不用担心特定的编程语言限制

  • 控制端:你的民宿PMS系统(网页后台、小程序、App)。

  • 通信协议: HTTPS(请求) + MQTT(设备下发,但对开发者透明)。

  • 核心设备: 芯步智能空调遥控器(推荐,解决90%空调机型) / 智能墙壁插座16A(大功率专用)。

三、 硬件选型

针对空调控制,芯步有几款产品非常适合,我们可以这样选择:

  1. 智能空调遥控器这是最推荐的方案。它本质是一个WiFi转红外的万能遥控器。你把它挂在房间墙上,对准空调,它就能学习或者直接匹配市面上绝大多数品牌空调的红外码。它的好处是不破坏原有电路,不管是挂机还是中央空调(只要带遥控器)都能控制,而且不仅能开关,还能调模式、温度、风速、扫风,体验最完整

  2. 智能墙壁插座(16A版本)如果民宿用的是插座取电的空调(通常是1.5匹-2匹挂机),可以直接更换墙上的16A空调插座。这种方案的优点是直接切断电源,控制非常彻底,而且带电量计量功能,你可以知道这台空调今天耗了多少度电。不过缺点也很明显:直接断电对空调压缩机有轻微损耗,而且再次通电后空调不一定自动开机(取决于空调品牌),所以一般来说优先推荐方案1(遥控器)

四、 详细对接步骤(实战篇)

这部分是真正的干货,我们直接看怎么把代码写出来。

第一步:准备工作——拿到“钥匙”

在芯步控制台完成以下操作:

  1. 注册账号,创建一个“工作台”。

  2. 在设备管理后台添加设备,将你买来的智能空调遥控器的ID(通常是一串数字或字符串)记录下。

  3. 获取 AppIDAppSecret(开发者密码),这是你调用接口的“身份证”

第二步:设备配网——让硬件连上WiFi

把设备拿到民宿房间里,插电。使用芯步提供的小程序或App,给设备配置上房间里的2.4G WiFi网络。这一步完成后,设备就在线了,你的后台也会显示设备状态为“在线”。

第三步:接口签名与调试(重点)

芯步的接口签名算法非常标准,我们只需要组装一下即可。

签名生成逻辑sign = md5( md5(AppSecret) + ts )

注意不要加号,是拼接。

  • ts 是当前的时间戳(秒级)。

举个实际的例子假设你的 AppID123ABCAppSecretxyz789

  1. 首先你把 AppSecret 进行一次MD5加密: md5(“xyz789”) = aaa111

  2. 然后拼接当前时间戳(假设是 1700000000),得到字符串: aaa1111700000000

  3. 把上面这串字符再进行一次MD5,最后得出的就是你的 sign

第四步:下发控制指令(核心代码)

现在我们试试下发一个“开机、制冷、24度”的命令。

请求地址https://api.thingboot.com/{你的AppID}/device/control/?sign={你算出的sign}&ts={当前时间戳}

请求方式POST

请求体 (Body)

关键点:关于红外码库,如果你不想这么细致地调参数,芯步的接口通常也支持“学习模式”。你可以先用遥控器按一下,让设备学习,然后直接把那一串码下发,但这通常比较麻烦,官方推荐的还是直接用上述JSON参数,设备内置的红外码库会自动转换成对应空调品牌的信号

第五步:集成到你的民宿软件里

现在你已经可以用Postman(接口测试工具)调通接口,把空调控制了。接下来就是和你的业务代码绑定:

  1. 第一种场景:订单自动匹配当客人在小程序下单成功后,你的后端逻辑可以不要立刻开空调(防止浪费),而是等到保洁打扫完毕,或者客人办理入住时,系统自动调用上述接口,把对应房间的空调打开,预设为26度。

  2. 第二种场景:PMS管理后台在民宿老板的PC后台,做一个简单的卡片界面。显示当前每个房间空调的运行状态(如果设备支持实时上报的话),旁边放一排按钮:【制冷22度】【制热26度】【关闭】

五、 想要更省事?试试场景联动

芯步的接口还支持设备与设备之间的联动。

  • 搭配温湿度传感器:通过接口读取传感器数据,如果发现房间温度低于10度且空调没开,可以程序触发“防冻模式”,自动打开空调制热

  • 搭配门磁:虽然芯步官网可能没直接提,但逻辑上是通的。客人一开门(门磁触发),你的系统收到门磁信号,再调接口发“空调开启指令”,实现人来即暖。

六、 避坑指南

最后,送给大家几个小:

  1. 关于中央空调:如果民宿用的是商用中央空调(大金、日立等),普通红外遥控器可能无效。这种情况一般需要用到VRF网关或特定的KNX网关来对接。不过芯步的红外遥控器覆盖了市面上90%的挂机,只要你的中央空调出风口带有普通红外接收头,它就能控制

  2. 关于内网与外网:芯步的设备默认走云端,你在家里也能控制民宿的空调。但如果你的民宿网络不稳定,可以考虑他们的私有化部署方案,但这需要一定的运维能力

  3. 状态同步:如果客人用实体遥控器按了空调,你的后台系统怎么知道温度变了?芯步的设备支持状态上报,你需要在自己服务器写一个接收回调的接口(Webhook),用于同步设备的最新状态,不然你后台显示24度,实际房间里是26度,那就尴尬了。

通过以上几步,你就能把芯步的空调控制能力无缝集成到自己的民宿管理软件中了。整个过程不需要懂底层的WiFi协议,只需要会发起HTTP请求就行,还是相当友好的。