CATALOG

芯步的60W语音音柱支持通过HTTP接口直接推送文本进行TTS播报,无需上传录音,响应速度在80-120ms左右。下面是具体的接入方案。

一、准备工作:拿到“钥匙”和“地址”

在写代码之前,我们需要先去芯步的开发者后台拿到几个关键信息,这就好比你要发快递,得知道收货地址和你的身份一样。

  1. 注册与登录:先去芯步官网注册一个开发者账号。

  2. 获取凭证:登录后,在控制台的“开发设置”里,你会找到两个非常重要的字符串:

    • AppID:相当于你的“用户名”。

    • AppSecret:相当于你的“密码”,这个千万别泄露给外人

  3. 设备上云:把你手里的60W音柱接通电源,连上WiFi(它只支持2.4G WiFi)。设备成功联网后,会在后台自动注册,你会得到一个 Device ID(设备编号),这是你要喊话的“具体对象”。

二、核心原理:其实就发一个HTTP请求

这个音柱的接口非常直白,它不用复杂的MQTT协议,你就把它当成一个可以通过网址来喊话的“机器人”。

你只需要在你的服务器上,向芯步的API地址发送一个 POST 请求就行了。

  • 请求地址https://api.thingboot.com/{你的AppID}/device/control/

  • 请求方法:POST

  • 请求体:包含目标设备ID和你要说的内容。

三、手把手写代码:以最常见的Python为例

假设我们要让音柱播报“【警告】车库发生火情,请迅速撤离!”。我们不仅播报,还顺便把音量调大。

这里有一个关键步骤——生成签名,这是为了安全,防止别人乱喊话。规则是:md5( md5(AppSecret) + ts ),听着复杂,代码就几行。

如果你用的是PHP,那段逻辑其实是一样的:

四、进阶玩法:光说话太枯燥,来点炫酷的

60W音柱不只是个喇叭,它还内置了很多好玩的参数,你可以在 order 里随心搭配。

  1. 调节音色语调想要男声、女声?语速快一点?加上 voicespeed 参数就行。

  2. 加上提示音先“叮咚”一声再说话,仪式感满满。[message_1][message_5] 是不同的提示音。

  3. 一套指令控制多台设备如果你们厂区很大,装了十几台音柱,想广播通知所有人吃午饭?把设备ID用逗号拼接就行,一秒同步播报。

五、注意事项

  1. 文本编码:命令里固定用 play:gbk:16,说明它内部是GBK编码。通常网络请求默认UTF-8,如果你发现中文乱码,需要把你发送的文本转成GBK编码再放进去。

  2. 数字读法:这个音柱挺智能的,如果你直接发“123”,它会读成“一百二十三”或“一二三”?接口支持手机号、金额的智能读法,大家看产品手册就好。

  3. 局域网模式:如果你们是内网环境,不想走外网,这个