民宿空调远程控制的痛点在于:既要让客人住得舒服(提前开空调、随时调温),又要防止人走空调忘关造成的电费浪费。芯步的“智能空调遥控器2”正好可以解决这个问题——它不是改装空调本身,而是通过红外模拟遥控器信号,再通过WiFi接入网络,最后用开放HTTP接口让你自己的系统来指挥它。
下面我会从硬件选型、接口对接逻辑、代码示例,到具体的业务场景,一步步说清楚。
一、 为什么需要“外挂”一个遥控器?
很多做民宿的朋友或者PMS系统开发商都会遇到一个头疼的问题:空调是传统的,不支持联网。如果为了智能化把全屋空调换了,成本太高不现实。
这时候,“红外遥控器”就是救星。芯步的 “智能空调遥控器2” 本质上是一个WiFi转红外的网关。把它往房间一放,它就能模仿实体遥控器发指令。我们要做的,就是通过代码告诉它:给空调发个16度的制冷指令。
二、 选型确认:硬件长什么样?
根据芯步的官方产品手册,智能空调遥控器2 具备以下特点,很适合民宿场景:
覆盖广:支持市面上90%以上带红外接收功能的空调(格力、美的、大金等都能兼容)。
联网快:只支持2.4G WiFi,不需要额外买网关,只要有网就能用。
接口开放:官方提供免费的HTTP接口,这意味着只要能联网发请求,在任何地方都能控制它。
三、 核心准备工作:拿到“钥匙”
在写代码之前,我们需要先在芯步的开放平台拿到三样东西。这就好比你要寄快递,得知道地址和收件人。
注册与创建:去芯步官网注册账号,创建一个“工作台”。
获取密钥
AppID:相当于你的项目身份证。
AppSecret:相当于你的密码,千万别泄露在前端代码里。
获取设备ID
把买来的“智能空调遥控器2”插上电,通过官网的“网络配置”或小程序给它连上民宿的WiFi。
配网成功后,在控制台设备列表里,你会看到一个叫
device的字符串(比如12345678)。这个就是这台空调遥控器的ID。
关键提示:芯步的接口是永久免费的,这点对于控制成本来说很友好。
四、 技术实现:怎么发指令?
芯步的接口设计得还算简单,主要有两种通讯方式:HTTP请求(短连接,适合PMS管理端)和 MQTT(长连接,适合小程序实时控制)。
由于你的需求是“接入到自己项目中”,通常我们会使用 HTTP 请求 来下发指令。
1. 接口地址与签名(Sign)
为了防止别人乱刷你的接口,请求需要带签名。公式如下:sign = md5(md5(AppSecret) + ts)
ts是当前时间戳(秒级)。这个逻辑一般在后端实现,前端只负责触发。
2. 下发控制指令
场景举例:客人刚在APP上订了房,前台系统自动帮他把202房间的空调开到20度制冷。
请求URL
https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}请求方式:
POST请求Body (JSON格式) :
注意细节如果你们发现空调没有反应,可以看一下返回码。返回 200 只代表平台收到指令了,不代表空调执行了。如果没反应,可能是红外码库不匹配,需要去控制台校对一下空调品牌。
五、 场景:接入项目的几个实用玩法
既然接口已经调通了,就可以根据业务逻辑来玩出花了。以下是几个比较实用的民宿运营场景:
第一种场景:住前迎宾(提升体验)
逻辑:PMS系统检测到“办理入住”事件 -> 调用接口。
指令:下发
{"power":1, "temp":22}。效果:客人顶着大太阳进房间,一股凉气扑面而来,好评自然就上来了。
第二种场景:离房节能(省电)
逻辑:门锁系统检测到客人出门(或者保洁打扫完标记为“空脏”/“空净”) -> 调用接口。
指令:下发
{"power":0}。效果:再也不用打电话催客人“出门关空调了”,每天能省下不少电费。
第三种场景:深夜睡眠模式
逻辑:定时任务(例如凌晨2点) -> 遍历所有“在住”状态的房间 -> 调用接口。
指令:如果空调温度低于24度,调回24度;或者调到“静音风速”。
效果:防止客人贪凉感冒,同时帮他们在睡梦中省电。
场景四:批量退房清扫
逻辑:管家端APP点击“退房打扫” -> 一键关闭该区域所有设备。
指令
device参数支持一次传多个ID,用逗号隔开(如device=123,456)。
六、 踩坑经验与避坑指南
在实际部署的时候,有几个容易踩的坑需要注意一下:
网络必须是2.4G现在的民宿路由器很多是双频合一。配网时大概率会失败。在后台设置里,或者用手机热点(设置成2.4G频段)先把设备配上网,或者让路由器开启2.4G模式。
关于状态同步HTTP指令下发后,如果客人用实体遥控器把空调关了,你的系统是不知道的。如果需要做“开关同步”,需要接消息推送(Webhook/MQTT),当设备状态改变时,平台会主动告诉你的服务器。
关于“就绪检测”有些空调关机后需要延迟几分钟才能开机(压缩机保护)。代码逻辑里最好加一个冷却时间(Cooldown),不要连续高频下发开关指令,否则空调会“罢工”一段时间。
七、 总结
把芯步的智能空调遥控器接入自己的项目,其实就是 “买硬件 -> 拿DeviceID -> 调HTTP接口” 这三步。
这种方式的好处是完全解耦。不管你的项目是用Java、Python还是PHP写的,不管你是做的小程序还是PC端管理后台,只要支持HTTP请求,就能把它接进去。这样一来,民宿的空调就不再是“死”的了,而是变成了你系统里一个可以随时调用的智能设备。