CATALOG

共享自习室的痛点就是“无人值守但要有温度”——用户超时了得提醒、快结束了得续费通知。这款款式2音箱正好能解决这个问题,通过HTTP接口调用,在你的软件系统里触发语音播报。下面我把整个对接过程拆开来讲,包括签名怎么算、命令怎么发、场景代码怎么写。

一、 为什么选“款式2”以及它能干什么?

在芯步的产品线里,智能语音壁挂音箱|款式2(其实在公开文档里常被称为“款式1”或基础款,这里我们统称为款式2)最适合自习室。

核心优势:

  • 极简对接:不需要像控制灯或插座那样写复杂的寄存器逻辑。你只需要给它发一个HTTP请求,告诉它“说人话”就行了

  • 真人发声:它不是那种刺耳的滴滴声,而是标准的TTS(文字转语音)。你可以选温柔的女生提醒“同学,时间快到啦”,或者严肃一点的男生提醒“超时未续费,即将断电”

  • 免录音:很多传统工业音箱要先把声音录进去,这个不需要。你的系统里有什么文本,它就实时念什么,非常灵活。

在这个场景里,它主要干三件事:

  1. 入座欢迎:用户扫码开门/通电后,播报“欢迎光临,祝您学习愉快”。

  2. 临期提醒:比如用户买了2小时,还剩15分钟时,播报“剩余15分钟,如需续费请在小程序操作”。

  3. 超时/离开现场时提醒:时间到了播报“时间已到,请收拾物品离开现场时,门禁即将关闭”。

二、 对接前的“准备工作”(一分钟搞定)

在写代码之前,你需要在芯步的后台做两件事,这在他们的控制台里就能搞定:

  1. 拿到钥匙:找到 AppIDAppSecret(开发者密码)。这是调用接口的凭证。

  2. 找到“员工”:找到你放在自习室角落那个音箱的 Device ID(设备ID)。把这个ID记下来,代码里要指着它喊话。

三、 核心逻辑:怎么让音箱“开口说话”?

这个音箱最方便的地方在于它使用 HTTP协议。不管你的后端是用 Java、Python、Go 还是 PHP,只要你的服务器能发网络请求,就能控制它。

芯步的API地址是固定的,关键点在于防盗链机制,也就是 Sign(签名) 的计算。

1. 签名计算(这是最容易出错的地方,敲黑板!)

所有请求都需要带签名,防止别人伪造你的指令乱喊话。算法是这个样子的

最终签名 = MD5 ( MD5 (AppSecret) + 当前时间戳 )

稍微解释一下:

  • 先把你的 AppSecret 做一次 MD5 加密,得到一串字符。

  • 把这串字符和当前的 Unix 时间戳(比如 1715234567)拼在一起。

  • 把拼接后的字符串再做一次 MD5 加密。

2. 核心“命令”代码

API 地址(POST 方法):https://api.thingboot.com/{你的AppID}/device/control/?sign={计算好的签名}&ts={当前时间戳}

重点看 Body (JSON 格式):

*注:play:gbk:16 是固定写法,代表以GBK编码播报文本,16 代表音量大小(0-16),这样一行指令,音箱就响了*

四、 实战场景:把语音嵌入你的自习室系统

假设你现在的软件系统是用 Java SpringBoot 写的(当然逻辑通用),我们来做一个“订单倒计时15分钟自动提醒”的功能。

第一步:写一个“喊话工具类”

你别每次都去算一遍签名,封装成一个函数最省事。