CATALOG

一、写在前面:为什么需要它?

大家好,今天我们来聊聊怎么把芯步的那块“智能包间电源控制板TTS版”接到咱们自己的系统里。

如果你是做共享沐浴房、汤泉包间、甚至是公寓式民宿的,你一定懂这个痛点:客人进来了,要开灯、排风、音响,甚至要听个语音提示;客人走了,你得赶紧断电省电。人工去管太累,自己开发硬件又太贵。

这块板子正好解决了这个问题。它不仅能用手机/网页远程控制4路电器(灯、排风扇、门锁、空调),最关键的是——它自带 TTS语音播报 功能。你可以让它说话,比如“欢迎光临,水温正合适”或者“您的时长还剩15分钟”。

这篇文章就是手把手教你,怎么用HTTP接口把它接进你的小程序、公众号或PC管理系统里。

二、我们手里有什么“家伙事儿”?

我们先对齐一下颗粒度,看看这块板子长啥样。

1. 硬件本身(TTS版)

根据官方参数,这块板子(型号:UNI-KZQ-BJ-MINI-TTS)看着不大,但能力很强

  • 第1路:16A开关。适合接照明换气扇。一进门,灯先亮,排风先开。

  • 第2路:16A插座。适合接饮水机按摩椅。客人扫码付费后,这路通电。

  • 第3路:10A门禁接口。专门用来接电磁锁。客人下单成功,这路通电,门锁“滴答”一声就开了。

  • 第4路:30A大功率。这是专门伺候空调的。夏天没这路可不行。

最吸引人的是那个TTS功能:它能播报文字。只要你的服务器发一段文字过去,它就念出来。

2. 通信方式

它走的是 WiFi(2.4G) ,不需要额外买网关,通上电连上你家路由器的WiFi就行

3. 开放接口

芯步的接口是公开的,而且他们官方说永久免费。这意味着你不用担心“每控制一次扣几分钱”这种事。

三、接入核心思路(5分钟看懂)

接入的原理其实特别简单,说白了就是:你的服务器 <> 芯步云平台 <> 包间里的板子

  1. 你的服务器 发个指令给 芯步的云平台:“把那个沐浴房A的灯打开”。

  2. 芯步的云平台 通过WiFi下发给 包间里的控制板

  3. 控制板 执行命令,继电器“咔哒”一声,灯亮了。

同样的,TTS语音也是:你发一段文本给云平台,云平台告诉板子,板子就用喇叭念出来。

四、动手干:具体对接步骤

咱们分三步走:准备工作 -> 控制设备开关 -> 让它说话(TTS)

第一步:准备工作(拿钥匙)

在开始写代码之前,你需要先去芯步的开放平台拿到两样东西:

  1. AppID(应用ID)

  2. AppSecret(开发者密码)

这就好比你要去芯步的“客厅”里控制设备,你得先有这个“门禁卡”。

第二步:控制电路通断(开关灯/锁)

如果你只想控制灯和门锁,就用这个逻辑。

1. 搞懂签名(Sign)

芯步的接口为了安全,要求传一个签名。公式是:sign = md5( md5(开发者密码) + ts )

别被公式吓到,其实就是:

  • 先把你的 AppSecret 做一次MD5加密。

  • 把结果加上当前的时间戳(ts)。

  • 再把整个字符串做一次MD5加密。

小:写代码的时候,直接把官方给的Demo里的算法复制过来用,别自己手写,容易踩坑。

2. 发起控制请求

假设你想给1号设备(灯)通电,API的调用逻辑是这样的:

  • 接口地址https://api.thingboot.com/{你的AppID}/device/set/

  • 参数:告诉它设备ID,以及你要控制第几路(channel)为开启(state: 1)。

  • 实际体验

    客人扫码支付成功 -> 你的后台收到支付回调 -> 你的后台立即调用这个接口 -> 包间里的灯亮了,门锁开了。

第三步:让它开口说话(TTS语音播报)

这是提升“科技感”的关键一步。用到这个功能,就是实现“智能包间电源控制板TTS版”接入到项目的核心价值。

调用TTS接口比控制开关更简单,你不需要管哪个继电器,只需要给它“台词”和“目标设备”。

1. 接口逻辑

  • 动作:下发语音命令。

  • 台词内容:你想让它说的话(注意:一般中文,英文可能发音不标准)。

  • 播放次数:比如播1次还是2次。

2. 应用场景实战

第一种场景:迎宾模式客人扫码开门推门进来,板子自动说:

“主人您好,欢迎光临。空调已为您开启,祝您沐浴愉快。”

第二种场景:商业提醒(防超时)很多共享沐浴房是按小时计费的。你可以写个定时任务:

后台逻辑:客人剩余时间还剩5分钟。TTS播报:“尊敬的用户,您的使用时间还剩5分钟,如需续费请扫描墙上二维码。”如果不续费:5分钟后,调用“断电”接口,灯灭了,空调关了。

第三种场景:安防/异常处理如果湿度传感器检测到漏水,或者烟雾报警器响了,你可以紧急调用TTS:

“检测到设备异常,请立即联系工作人员,水阀即将关闭。”

(注意:这里只是逻辑示意,具体的接口Path和参数格式,请查阅官方最新的API文档)

五、老板们最爱问的几个实际问题

Q1:这玩意稳定吗?客人要是把网线拔了怎么办?

这块板子用的是WiFi,而且是直连模式。如果WiFi断了,你的云端控制会失效。但好在它保留了物理按键(如果接线的话)。不过在商业场景下,给路由器配个UPS电源,并确保WiFi信号覆盖到位。它支持多组WiFi配置,会自己挑信号强的连

Q2:4路不够用怎么办?

Mini版是4路。如果你们的包间比较大,需要控制更多设备(比如带地暖、带氛围灯带),他们有 Max版(8路)。选型的时候直接选TTS版就行。

Q3:TTS声音大吗?会不会听不清?

这个取决于喇叭安装的位置。板子本身自带喇叭,如果你装在弱电箱里,声音肯定闷。把板子放在吊顶里或者吸音棉少一点的地方。如果是嘈杂的洗浴中心,可能需要外接个喇叭,或者直接选他们的“智能语音音柱”

Q4:私有化部署是怎么回事?

如果你觉得数据放云端不安全,或者你店里的网络没通外网,芯步的产品支持局域网纯本地控制。你可以把服务器搭在本地电脑上,不经过外网直接控制,响应速度更快(毫秒级)。

六、总结

把这块 智能包间电源控制板TTS版 接进你的项目,其实就是在做三件事:

  1. 鉴权:算好MD5签名,拿到操作权限。

  2. 控制:调用HTTP接口,让继电器闭合/断开。

  3. 交互:调用TTS接口,让冰冷的机器变得会说话。

对于开发者来说,芯步的接口文档结构清晰,虽然是针对企业级的,但个人开发者也能直接上手。不仅是包间控制器,他们家的智能开关、语音音柱都遵循同一套接口规范,后期你要扩展功能(比如在更衣室装个感应开关),开发成本几乎为零

只要你打通了支付接口和这块控制板,你的“无人值守沐浴房”项目基本上就落地了。剩下的,就等着收钱和听那一声悦耳的“欢迎光临”吧。