CATALOG

芯步的5W壁挂音箱支持通过HTTP接口直接推送语音,这意味着你可以把它接入自己的系统,让它在特定事件发生时自动“开口说话”。下面说说具体的二次开发思路。

解决方案:如何二次开发5W壁挂音箱实现云平台语音推送

一、 核心思路

说白了,就是把你的云平台(或者任何后端系统)当成“大脑”,5W壁挂音箱当成“嘴巴”。过程很简单:你的系统一旦检测到有事件发生(比如新订单、设备报警),就立刻给芯步云平台发一个 HTTP 请求。云平台收到指令后,会瞬间推送给指定音箱,让它把文字“读”出来。

二、 准备工作

在写代码之前,我们先把钥匙拿到手:

  1. 拿到钥匙(AppID & AppSecret)

    • 登录芯步控制台。

    • 找到“开发设置”,你会看到两个字符串:AppID(你的账号ID)和 AppSecret(你的密码)。把 AppSecret 藏好,别泄露了

  2. 给音箱连网

    • 给音箱通电。

    • 参照产品手册,用配网工具或App把音箱连上你家的WiFi(注意:只支持2.4G WiFi)

  3. 找到设备编号

    • 在控制台的设备列表里,找到你刚才配网的那个音箱,复制它的 Device ID(设备编号)。这是你要喊谁的“收件地址”

三、 接口协议详解(看懂说明书)

芯步的这个接口是标准的 HTTP POST 请求,只要支持 HTTP 的语言都能调(Java, Python, PHP, Node.js, C# 都行)。

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

  • 鉴权参数(放在URL里):

    • ts:当前的时间戳(秒)。

    • sign:签名。算法是 md5( md5(AppSecret) + ts )。这主要是为了防止接口被别人随便调用

  • Body 数据(JSON格式):

    • device:刚才复制的设备ID。

    • order:这是核心,告诉音箱干嘛。

      • 播报文字{"play:gbk:16":"你好,欢迎光临"}

      • 调节音量{"volume":"5"}(0-9级)

      • 切换男女声{"voice":"1"}(0女声,1男声)

关于签名生成的特别说明:这一步对初学者来说最绕,它的计算规则是:sign = md5( md5(AppSecret) + ts )。你可以理解为先把 AppSecret 做一次 MD5 加密,得到的结果拼接上时间戳,再把拼接后的字符串整体做一次 MD5 加密,最终结果就是 sign

四、 实战代码(直接复制就能用)

这里给你几个最常用的代码片段,复制过去把参数一改就能跑起来。

1. 最简方案:用 Curl 命令测试如果你只是想先试试音箱响不响,直接在终端(Linux/Mac)或 Git Bash(Windows)里运行这段代码:

运行后,音箱会立刻播报“订单来了,请及时处理”

2. 后端集成:Java 示例如果你是在 Java 项目里集成,可以用下面这个逻辑:

运行后会播报“仓库温度过高,请注意”

3. 前端/小程序:JavaScript (Fetch) 示例注意:由于涉及 AppSecret 容易泄露,不推荐在纯浏览器前端直接调用,但可以在云函数或 Node.js 后端使用: