CATALOG

芯步的5W壁挂音箱支持通过HTTP接口远程控制音色、音调等参数,核心思路是在order字段里同时下发“设置参数”和“播报内容”两个指令。下面按步骤说明具体怎么实现。

一、准备工作

在开始“调音”之前,我们需要先把“路”修通。你不需要懂硬件电路,只要能让你的电脑或服务器给芯步的云端发一个HTTP请求就行。

  1. 拿到钥匙 (AppID & AppSecret)登录芯步的物联网控制台。找到“开发设置”,系统会给你生成两串字符串:AppID(相当于用户名)和 AppSecret(相当于密码)。保管好 Secret,别泄露到前端代码里

  2. 找到你的设备 (Device ID)在控制台的设备列表里,找到你这台“5W 壁挂音箱”。把它那一长串的 Device ID 复制出来(例如 820720

  3. 联网确保你的音箱已经通过 WiFi(2.4G)连上了网。芯步的设备支持直接联网,不需要额外的网关

二、核心思路:两条腿走路

很多人以为只能让音箱“说话”,其实它的 HTTP 接口是支持状态控制内容播报并行或分开执行的。

要设置音色,我们不需要每次说话都带上一大堆参数。

  • 方案 A(推荐):先设置,后播报。 先发一条命令把音箱默认音色改成“男声”或“女声”,后续只管发内容。

  • 方案 B:即说即设置。 在播报文本的同时,临时改变这次发声的音色。

三、具体怎么发命令?

芯步的接口地址格式是固定的,你需要往这个地址 POST 一段 JSON 数据 接口地址http(s)://api.thingboot.com/{你的AppId}/device/control/?sign={签名}&ts={时间戳}

由于 HTTP 协议是公开的,用 Python、Java、PHP 甚至用电脑自带的 curl 命令都能发。这里主要讲数据包里面的内容怎么写。

1. 改变音色(男声/女声切换)

这个音箱支持通过修改 order 里的 voice 字段来改变音色

  • 设置女声"voice": "female"

  • 设置男声"voice": "male"

请求 Body 示例

2. 改变音调/语速(让声音更活泼或更沉稳)

想让声音听起来“年轻一点”或者“严肃一点”,需要调整 tone(音调)和 speed(语速)参数。这两个参数通常是 0-9 的整数级别

  • 语速 (speed)0 最慢,9 最快。推荐 5(正常)。

  • 音调 (tone)0 最低沉,9 最尖锐。推荐 4-6

请求 Body 示例

注意:这个设置会保存在设备里,直到你下次修改。

3. 一边播报一边调音(进阶玩法)

如果你不想改变设备的默认设置,只是想让某一句特定的话用特殊声音读出来,可以把参数和播放命令放在一起

请求 Body 示例

四、实操小实验:用 curl 调一次音

假设你现在就在电脑前,如果你装了 Linux 或 Git Bash,可以试试下面这个命令(记得替换 AppID, AppSecret, Device ID):

如果一切正常,音箱会“滴”一声或者直接生效,接下来它说的所有话就都变成“活泼女声”了。

五、几个避坑小贴士

  1. 签名算法容易错:芯步的签名是 md5( md5(AppSecret) + ts )。很多人容易忘记外层 MD5 之前要把内层 MD5 的结果(32位小写)直接跟 ts 拼接成字符串,而不是把它们当成 Hex 数字相加

  2. 中文字符编码:在 play:gbk:16 命令中,如果遇到生僻字乱码,记得检查你的代码环境是不是用了 UTF-8 编码发送,有些旧固件可能需要 GBK 编码。官方示例用的是 play:gbk:16

  3. 区分大小写:JSON 里的 Key 比如 device, order, voice 都是小写,别手滑写成大写。

  4. 局域网模式:如果你把音箱部署在封闭内网(没有外网权限),芯步也支持私有化部署。这时候你的 API 地址要换成你自己搭建的服务端 IP,而不是 api.thingboot.com

总结

只要掌握了 voice(音色)、tone(语调)、speed(语速)这三个核心参数,你就可以随心所欲地“调教”这款 5W 壁挂音箱了。在系统里先把设备注册好,用 Postman 调通一次,后续代码复制粘贴就行了。