CATALOG

芯步的开放接口采用标准HTTP协议,无论控制空调开关、温度还是风力,本质上都是一个API请求。以下是基于其红外遥控器、智能插座、包间控制器三套方案的完整实现路径。

一、 背景与选型分析

在线下服务场景(如连锁餐厅、办公室、自习室、酒店客房)中,空调控制面临三个痛点:管理分散(无法统一开关)、人为浪费(无人时未关)、调节滞后(需人工到现场)。

基于芯步生态,通常有三种硬件对接方案,根据场景需求和空调类型选择:

方案类型适用场景控制粒度优势对应产品示例
红外遥控方案壁挂机、柜机(带遥控器)全功能:模式、温度、风力不改线路,即贴即用,支持逻辑闭环智能空调遥控器
通断控制方案大功率空调、2匹左右柜机基础:开关机简单可靠,承载功率大,成本较低智能墙壁插座16A / 智能通断器
场景集成方案茶室、棋牌室、包间全屋联动高度集成,可同时控制灯光、门锁、空调智能包间控制器

推荐首选:为了实现“温度风力调节”,智能空调遥控器是最佳选择。它模拟红外信号,不仅能开关,还能像实体遥控器一样设定到26℃、制冷/制热模式、自动风速。

二、 核心对接原理:API与设备交互

芯步的设备开放接口基于 HTTP/HTTPS 协议,采用 POST 请求方式。这意味着你的线下业务系统(如小程序后台、PC管理软件、自助机终端)可以通过发送JSON数据包直接控制硬件。

1. 对接流程图

sequenceDiagram
    participant SaaS as 业务系统/小程序
    participant API as 芯步开放API
    participant Device as 智能空调遥控器
    participant AC as 空调

    SaaS->>API: POST /device/control (签名+设备ID+指令)
    API-->>SaaS: 返回状态(成功/失败)
    API->>Device: 下发指令(红外码库匹配)
    Device->>AC: 发射红外信号(温度/风力)
    AC-->>Device: 执行结果上报
    Device-->>API: 状态回传

2. 鉴权与连接所有接口调用都需要携带 AppIDsign(签名)、ts(时间戳)以防止篡改。设备通过WiFi 2.4G联网,支持局域网纯网络环境运行,这意味着即使外网断开,只要局域网通,控制依然有效

三、 具体实施步骤:如何实现温度与风力调节

以下以智能空调遥控器为例,详细说明如何实现“降温/升温”和“调大风/调小风”。

第一步:环境准备与设备配网

  1. 注册与创建应用:在芯步开发者后台注册账号,获取 AppIDAPI Key(用于生成签名)

  2. 设备上线:将智能空调遥控器接通电源,通过热点配网或扫码配网将其连接到本地WiFi。在后台绑定设备ID(一串数字,如 820720

  3. 码库匹配:在后台配置空调品牌(如格力、美的)。芯步设备内置了市面上主流品牌的红外码库,这一步确保设备发出的信号能被你的空调识别

第二步:接口调试与指令下发

要实现控制,你只需要向特定的API地址发送如下结构的HTTP请求。

请求示例(控制温度为24℃,制冷模式,自动风速):

  • URL: https://api.thingboot.com/{AppID}/device/control/?sign=xxxx&ts=1712123123

  • Method: POST

  • Body (JSON):

针对不同场景的指令集构建逻辑:

业务场景业务逻辑代码 (伪代码/JSON逻辑)对应物理效果
上班/营业前预冷order.temp = 26order.windspeed = "high"快速降温,在顾客到达前将室温拉低至26℃。
节能强制约束if room.empty: order.power = 0if temp < 18: order.mode = "off"人走灯灭同时关空调,或冬季限制最高温。
顾客精准调节user.set(22℃, 中风) -> API.order服务员不用跑腿,顾客扫码一键调整头顶空调。

第三步:数据上报与闭环控制(高级联动)

单纯的控制是单向的,为了实现恒温节能,需要结合芯步的传感器。

场景实例:会议室/办公室智能恒温

  1. 设备组合:智能空调遥控器 + 智能温湿度传感器。

  2. 传感器逻辑:传感器实时采集当前温度(例如检测到25℃)。

  3. 服务器逻辑:你的服务器收到传感器上报的25℃数据,假设设定目标是24℃,则自动触发指令:{"temp":24, "windspeed":"low"}

  4. 风力调节:当温度降至24℃时,服务器再次下发指令 {"windspeed":"auto"} 或调低风速,避免冷感过强

接口响应处理芯步API会在80-120ms内响应。你需要处理返回码:

  • 200: 指令下达成功(设备已收到)。

  • 4xx/5xx: 重试或记录日志。

  • 设备离线处理:若设备离线,API会返回特定错误码,业务系统需提示“设备不在线”

四、 特殊场景:大功率及老旧空调改造

如果你的线下场景使用的是中央空调风盘功率超过2匹的柜机,红外遥控可能信号不稳或无法覆盖。

此时可以采用智能通断器方案

  1. 硬件:芯步智能通断器AC4-20A/30A

  2. 温度风力调节的实现方式:虽然通断器只控制“火线”通断,但结合上述的温度传感器逻辑,可以实现“恒温”效果。例如:温度高于26℃ -> 闭合继电器(启动空调),此时空调需预设为制冷模式;温度低于24℃ -> 断开继电器(关闭空调)。注:这种方式实现风力调节较难,但可通过控制压缩机的启停来实现温度恒定。

五、 总结

利用芯步开放接口在线下服务场景实现空调控制,核心在于 “一次对接,全场景覆盖”

  1. 能力:利用 智能空调遥控器 的丰富指令集(mode/temp/windspeed)解决风力、模式调节问题。

  2. 路径:通过标准的 HTTP API 将线下硬件无缝对接到微信小程序、PC收银系统或IoT中控台。

  3. 亮点:结合 传感器数据上报,形成“感知-决策-执行”的AI闭环,实现真正的无人化节能管理。

开发者只需关注业务逻辑(何时开、开多少度),无需关心底层通信细节,所有复杂的透传与重试机制由芯步的开放平台承担。

遥控器产品方案:
店铺空调设备控制:怎么将万能空调遥控器接入到软件项目中
查看 >>
怎样对接智能红外空调遥控器以实现本地按键控制空调
查看 >>
店铺空调设备控制:怎么将空调模式温度控制器集成到软件项目中
查看 >>
怎样接入HTTP接口空调控制器2来实现远程发送空调控制指令
查看 >>
怎么在智能化改造空调场景中集成智能设备来实现定时任务控制空调
查看 >>
空调场景方案:
无人值守空调场景:如何将红外发射空调控制器对接到自己的项目中
查看 >>
怎么在酒店客房智能控制中接入智能设备来实现定时开关空调等大功率设备
查看 >>
怎么在4路包间多回路控制模块MINI中集成智能设备来实现空调电源控制
查看 >>
店铺空调设备控制:怎么将空调模式温度控制器集成到软件项目中
查看 >>
店铺空调设备控制:怎么将万能空调遥控器接入到软件项目中
查看 >>
风力用途方案:
怎么二次开发空调自动化控制模块2来实现空调风力调节
查看 >>
怎么对接智能空调远程控制器来实现温度风力调节控制
查看 >>
怎么在线下服务场景空调控制中对接智能设备来实现温度风力调节控制
查看 >>
怎么在学校教室空调控制中对接智能设备来实现温度风力调节控制
查看 >>
怎么在设备机房空调管理中对接智能硬件以实现空调风力调节
查看 >>