CATALOG

芯步的这款15W壁挂音箱支持通过HTTP接口远程控制音量和音色,本质就是向设备发送一条JSON指令。下面按接入流程一步步说清楚,附带Java、Python、小程序等常见语言的示例思路。

一、 接入前的准备

在开始写代码之前,需要先搞定三样东西,就像开锁需要钥匙一样:

  1. 拿到“身份证”和“密码”

    • 登录芯步的控制台,找到 AppIDAppSecret

    • 白话解释:AppID 是你的账号标识,AppSecret 是用来加密的密码,千万别泄露

  2. 找到“门牌号”

    • 在控制台的设备列表里,找到你那台15W壁挂音箱的 Device ID(设备ID)。这是你要指挥的具体对象

  3. 确认设备在线

    • 确保音箱已经通电并连上了Wi-Fi(2.4G频段)。如果离线,就像手机没信号,命令是发不过去的

二、 核心“调音”指令集

芯步的接口非常直白,只要你懂一点HTTP请求,就能上手。针对这款15W音箱,调节音质主要靠以下四个参数。

敲黑板: 所有操作都是通过向设备下发一个 JSON 字符串 来完成的

1. 调节音量

  • 场景:下午大家犯困想提神,把音量调大;午休时想调小。

  • 命令内容

  • 说明volume 参数范围一般是 0-100,根据你的需求填数字就行。

2. 调节音色

  • 场景:商场促销用女声更亲切,工厂警报用男声更严肃。

  • 命令内容

  • 说明voice 参数通常 0 代表女声,1 代表男声(具体请以手册为准,不同固件可能有差异)

3. 调节语速

  • 场景:播报免责声明需要慢一点清晰一点,播报股票行情需要快一点。

  • 命令内容

  • 说明:范围一般是 0-9(由慢到快),默认通常是 5。

4. 调节语调

  • 场景:想让声音更活泼或者更沉稳。

  • 命令内容

  • 说明:范围一般是 0-9,数值影响音调的高低起伏

三、 动手实战:如何发送请求

既然知道了发什么(What),现在看看怎么发(How)。音箱开放了HTTP接口,任何能发网路请求的语言都能搞定。核心请求地址 结构如下:

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

这里的 sign(签名)生成规则是为了安全,公式有点小绕:sign = md5( md5(AppSecret) + ts )

示例场景

接下来演示如何“把音量调到80%”。

  • 设备ID100862828

  • 目标指令{"volume": 80}

写法1:如果你用命令行(curl)

这是最直接的测试方法,适合后端开发调试:

写法2:如果你用Python

适合需要跑自动化脚本的场景:

写法3:如果你用微信小程序或前端JS

在浏览器或小程序里需要注意安全,AppSecret 最好别写在前端代码里(容易被看光),通过自己的后端转发。不过如果你只是本地测试,引入 md5 库后可以这样发:

四、 实际应用小贴士

  1. 调试:先用 Apifox 或 Postman 测试,把签名算法调通了再去写代码。签名错了会报签名错误,这是最常见的坑。

  2. 恢复现场:在你的系统里做个“复位”或“默认设置”按钮。比如早上开门设置音量为70、音色女声;晚上闭店或者午休时调用 {"volume": 20} 把声音降下来。

  3. 不只是调音:这个接口也能用来播报文字。比如发送 {"play:gbk:16":"前台有人找"},音箱就会立刻说话。你可以把“调音”和“播报”写在同一个业务流程里。

  4. 局域网直连:这款音箱也支持私有化部署,如果你是在工厂内网且没有外网,可以把请求发到音箱的局域网IP,具体参照设备网络状态页面的提示

搞定这些,你的 15W 壁挂音箱就能完全受你控制了,想温柔就温柔,想激昂就激昂。