CATALOG

这是一篇关于如何接入芯步24路智能分体控制器,实现“一键场景切换”的解决方案。我尽量写得详细、口语化一点,方便你直接拿去给团队看或者落地实施。

兄弟们,在搞智能展厅、无人自习室,或者那种大型沙盘模型的时候,你有没有遇到这种情况:每次下班或者切换展示模式,得像个保安巡逻一样,手动去关一堆灯、开另一堆设备,不仅麻烦还容易漏。

现在咱们有了 “24路智能分体远程控制设备” (也叫UNI-KZQ-TY-24),配合它开放的 HTTP API接口 ,咱们完全可以把这24个回路“编成组”。

今天这篇方案,就是手把手教大家怎么通过代码,把这24路继电器变成听话的“小弟”,实现“一键下班”、“一键影音模式”、“一键营业”

第一步:先认识一下咱们的“硬件大哥”

首先,你得拿到手这个硬件。简单介绍一下这家伙:

  1. 接口多:它真的有24个独立开关。你可以接灯、接风扇、接幕布、接插座。

  2. 能扛能打:每一路最大能带 2200W 的阻性负载(也就是普通灯泡、插座),总功率 4400W。如果接的是电机(感性负载),比如投影幕升降,大概能带 350W

  3. 怎么联网:它连你家的 2.4G WiFi,不需要多余的网关,插电即用

  4. 核心优势:它支持 HTTP API 接口。这玩意啥意思?就是说,你任何一个后端语言(Java, Python, Go, PHP)或者前端(Ajax)甚至小程序,只要能发HTTP请求,就能控制它

第二步:接入前的“开胃菜”——配网和拿钥匙

在做开发前,我们得先把硬件搞定。这一步说白了就是让设备连上WiFi,并且拿到它的控制权。

你需要做这几件事:

  1. 注册&登录:去芯步官网注册个账号

  2. 配网:用微信小程序“芯步”,把家里/公司的2.4G WiFi密码告诉这个控制器。这步很简单,小程序里点“添加设备”,跟着走就行

  3. 拿AppID和AppSecret:登录官网工作台,在“开发设置”里,你会看到一串像密码一样的AppIDAppSecret这两个东西特别重要,相当于你控制设备的账号密码,不要泄露出去

第三步:最关键的来了——怎么用代码“一键切换”

好了,环境好了,设备也亮了,咱们开始撸逻辑。

你想实现“一键场景切换”,其实就是在一个请求里,告诉这24路继电器:哪几路给我开,哪几路给我关。

假设我们要设置一个 “观影模式”

  • 第1路(主灯):关

  • 第2路(氛围灯带):开

  • 第3路(投影幕):降下来(需要配合点动,这里简单先做通电)

  • 第4路(功放):开

1. 签名的生成(这是最绕的,我大白话解释)

芯步为了防止别人乱发指令,需要你在请求网址上加一个签名(Sign)和一个时间戳(ts)。大白话步骤:

把你在后台拿到的 AppSecret 进行 MD5 加密,得到一个字符串,再在这个字符串后面拼接上当前的时间戳,然后把这一整串再 MD5 一次,最后的这个东西就是 Sign。

公式就是:Sign = md5( md5(你的AppSecret) + 当前时间戳 )

2. 写代码实现“一键控制”

虽然官方给了很多例子,但24路控制的核心在于 order 这个参数怎么传。

我们有两种玩法:

  • 玩法A:单个控制(用于调试)比如只控制第1路开:{"power1":1}

  • 玩法B:批量/场景控制(重点)比如我们要执行一个“迎宾模式”,一次性定义所有24路的状态。你可以发送一个JSON字符串:

这里要提醒一下,不要相信网上的谣言,像什么“分两次请求会影响设备寿命”那是扯淡的。HTTP接口就是拿来高频用的,只要你的程序逻辑不崩,随便切模式,固态继电器的寿命很长的

实操代码片段(以Python为例):(这里假设你读到了设备ID是 1878)

只要你把这个代码里的 order_dict 换成不同的配置(比如 power1power5 开,其他关),那就是“演示模式”;全部关,那就是“一键下班模式”。

第四步:高级玩法——如果你不想走“云端”(局域网/私有化)

如果你觉得数据绕一圈云端有点慢,或者现场没外网,这设备也支持 局域网控制 或者 私有化部署

怎么切私有化模式?这设备有个彩蛋。它有个“调试热点”,名字叫 unisoft,密码是 unisoft.cn。连上那个热点,或者通过物理按钮(长按直到灯快闪,然后根据按的次数选择模式),你可以把设备切成“私有化模式”

切完之后,设备就不再往公网发数据了,而是直接往你指定的局域网IP发指令,延迟能压到几十毫秒。这对于需要实时反馈的联动非常重要。

总结:怎么对接最舒服?

  1. 小规模/测试:直接用官方API走云端。你写个脚本或者用 Postman 调一下https://api.thingboot.com/...,马上就能看到灯闪。这是最快的方式。

  2. 系统集成/正式用:在后台管理界面加几个按钮,比如“电影模式”、“阅读模式”。按钮点下去,后端就执行像上面那样的 Python/Java 代码,给设备发 power1=1, power2=0... 这样的指令就行。

  3. 切记AppSecret 记得放后端,别写死在前端网页里,不然容易被别人抓包乱控你的设备。

只要搞定了上面这个 “签名”“Order命令” ,你就相当于拥有了一个“24路遥控器”,想怎么编组,逻辑都在你代码里,想怎么玩都行。