CATALOG

芯步这款10W壁挂音箱本身开放了HTTP接口,对接思路很直接——把音箱当成一个“能发声的API终端”就行。下面从准备工作到代码实现,一步步说清楚。

一、 前期准备:先把家伙事儿备齐

在动手敲代码之前,我们得先把“钥匙”和“目标”准备好。

  1. 硬件上岗:给“智能语音壁挂音箱10W”插上电。它支持WiFi 2.4G 和有线网版 ,在配置界面里给它连上你办公室的网。只要它和你的服务器在同一个局域网,或者都能上互联网就行。

  2. 获取核心钥匙(AppID & AppSecret)

    • 去芯步的开发者后台,注册一个账号。

    • 找到“控制台” -> “开发设置”。你会看到两个字符串:

      • AppID:就像你的“用户名”,告诉服务器是谁在调用。

      • AppSecret:像你的“密码”,千万别写在网页前端代码里,只放后端用。

  3. 找到目标设备ID

    • 在后台的“设备管理”列表里,找到你那台10W音箱。它有一串唯一的编号,这就是Device ID(比如文档里常见的1878。如果你有10台,记下这10个ID就行。

二、 核心原理:其实是“一句话的事儿”

这个音箱最方便的地方在于它集成了TTS(文字转语音) 芯片

这意味着你不需要在电脑上录MP3,也不用搞音频转换。你只需要用最HTTP协议,给它发一句“订单号89757,请尽快取餐”,它那边就直接用合成的语音读出来了。

接口信息摘要

  • 请求地址https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}

  • 方法: POST

  • 数据格式: JSON

三、 实战步骤:写代码(只要核心4行)

这里咱们用最常用的 PHPPython 举例,逻辑是通用的,其他语言照葫芦画瓢就行。

最关键的一步是生成签名。官方规则是:md5( md5(AppSecret) + ts )。简单说就是把你的密码MD5加密一次,再拼上当前时间,整体再加密一次。这么做是为了防止别人伪造请求。

方案 A:最简单的推送(Python 版)

假设你的业务系统(比如订单系统)收到了一个新订单,需要音箱喊一声“请注意,新订单来了”。

方案 B:高级控制(音量+音色)

如果你的环境比较嘈杂,或者夜里想调低音量,可以在 order 里加上控制参数。

四、 高级技巧:让它更像“真人”播报

官方接口支持一些特殊控制,你可以按需加在文本里

  1. 处理多音字:比如“重庆银行”,默认读“重(中)庆”不准。

    • 技巧:可以写成“重(众)庆银行”,强制矫正发音。

  2. 数字读法

    • 如果你的文本是“余额 200.50”,想让它读成“两百点五”,直接传就行,智能音箱自动识别。

    • 如果需要读成金额“二百元五角”,直接写汉字。

  3. 插入停顿

    • 可以在文本里加逗号或句号。例如:“紧急通知,请全员注意,系统将在五分钟内关闭。”

  4. 加入前奏铃声

    • 有时候直接说话太突兀,可以加个“叮咚”。

    • 可以在播报文本前调用内置铃声命令(具体参考官方设备手册里的铃声ID)。

五、 常见避坑指南

  1. 时间戳有效期ts 参数通常要求在请求发起后的 5分钟 内。时间戳太旧,服务器会拒绝请求。记得检查你服务器的系统时间是不是标准北京时间。

  2. 中文编码:虽然官方示例用了gbk,但在绝大多数现代编程环境下,直接传 UTF-8 的中文是没问题的。如果遇到乱码,把代码文件的编码改成UTF-8。

  3. WiFi信号:10W壁挂音箱虽然支持设置5组WiFi自动切换,但如果挂在厂房角落信号不好,可能会有延迟。先用手机Ping一下音箱的IP(在路由器后台看),确保延迟稳定。

  4. 局域网模式:如果你担心数据安全不想走外网,芯步支持私有化部署。你可以把API请求地址改成你内网服务器的IP,所有数据只在你们公司内部流转。

六、 总结一下整个流程

  1. 写个脚本,把上面的代码框架复制进去,填上你的Key和ID。

  2. 跑一下测试,点运行。如果听到音箱响,那就算打通了。

  3. 接入业务:把这段代码放进你的后端服务里。比如订单创建成功后,就在代码后面调用一下这个接口。

这样,你的“10W壁挂语音通知音箱”就不再是一个单纯的喇叭,而是变成了你业务系统的“嘴”。