CATALOG

会议室里空调要么忘关要么找不到遥控器,确实是很多公司的痛点。芯步这款红外遥控器带HTTP接口,可以把它直接挂到你的内部系统里——不管是会议室预订系统、企业微信小程序,还是自建的控制台。下面从拿到设备到最终接入,一步步说清楚。

一、 准备阶段:先把“硬骨头”搞定

在写代码之前,我们需要先把物理设备配上网,并且拿到几个关键的身份凭证。

1. 硬件接线与摆放把你拿到的“芯步智能空调遥控器”插上电。关键点:这个家伙是红外的,它像你手里的电视遥控器一样,不能穿墙,也不能被柜子挡住。你需要把它放在会议室里能“看见”空调的位置,比如天花板的角落或者空调正对面的墙上,距离一般在7-8米内比较稳妥

2. 给设备配网(2.4G WiFi)芯步的设备通常支持“小程序配网”或“控制台配网”。

  • 手机微信搜索“芯步”小程序。

  • 登录你的账号(没有就注册一个)。

  • 选择你的“工作台”,点击右上角的“+”号,输入会议室的 2.4G WiFi 密码(注意:很多物联网设备不支持5G频段,一定要选2.4G,否则连不上)。

  • 长按遥控器上的配对按钮(通常是红灯快闪状态),小程序里点“添加设备”,听到“滴”的一声或者指示灯常亮,就代表连上网了。

3. 找到你的核心“三要素”想要控制这台设备,你的代码需要知道三个信息:

  • AppID(应用ID):登录芯步官网后台,在“控制台”顶部可以看到,相当于你这套系统的“账号”。

  • Device ID(设备ID):在设备列表里,这台空调遥控器旁边的一串数字(如 1002

  • Sign(签名):为了安全,每次发指令都需要一个签名。芯步通常要求 sign = md5(AppID + AppSecret + ts) 的方式生成。AppSecret(密钥) 在后台的“应用详情”里,千万别泄露给别人。

二、 开发实战:如何优雅地控制空调?

搞定网络和凭证,我们就可以进入正题了。通常控制空调分两种场景:云端控制(人在公司外,通过服务器发指令)和局域网控制(内网直接发指令,速度更快)。

方案 A:云端/远程控制(适合远程办公、定时任务)

如果你需要在下班后统一检查所有会议室空调是否关闭,或者想集成到钉钉/飞书里,就用这个接口。

1. 获取设备当前状态在动手控制之前,最好先看看空调现在啥情况。接口地址(GET方式):

你会收到一串JSON数据

如果你的项目界面需要显示当前温度,从这个接口拿数据就行。

2. 下发控制命令(关键)这是最核心的一步。比如开会前10分钟,自动把空调打开。接口地址(POST方式):http(s)://api.thingboot.com/{AppID}/device/control/

请求参数示例(以 x-www-form-urlencoded 格式为例)

(注:具体的 order 字段里支持什么参数,比如 windspeedauto 还是 1,2,3,看一眼产品的具体手册)

小技巧:如果你用的是 Python,代码大概长这样:

方案 B:局域网/内网直连(推荐,反应极快)

如果你的会议管理系统部署在公司内网,强烈用这种方式。芯步的设备其实支持局域网“私有化”控制,省去了数据去云端绕一圈的时间,几乎是秒开

前提:你的服务器必须和空调遥控器在同一个局域网操作步骤:

  1. 先去后台查一下分配给这个遥控器的局域网IP地址(比如 192.168.1.100)。