CATALOG

芯步的30W音柱支持通过HTTP接口直接下发文本播报,非常适合做设备状态的实时语音反馈。下面这套方案从签名计算、接口调用到代码示例都梳理出来了,你可以直接拿去用。

怎么对接30W自动语音通知音柱,实现设备状态语音反馈?

一句话概括:这事儿其实不复杂。芯步的这款30W音柱,说白了就是一个会发声的“API执行器”。你这边只要按照规矩,给它发一个HTTP请求(里面带上你要说的话),它立马就能喊出来。

对于我们“设备状态反馈”这个场景,就是当你的设备(比如传感器、PLC、或者某个机器)状态发生变化时,触发一段程序,调用这个接口。

下面我手把手带你过一遍这个对接流程,虽然技术细节跑不掉,但我会尽量说得像聊天一样好懂。

第一部分:准备工作(就像炒菜要先备菜)

在动手写代码之前,需要先找齐三样东西,都在芯步的后台能看到

  1. AppID:你的“身份证号”,标识是哪个应用在调用。

  2. AppSecret:你的“密码”,这个千万不能泄露到前端代码里,只在后台用。

  3. Device ID:那台30W音柱的“电话号码”。把它添加到你的设备列表里,抄下来这个ID。

第二部分:核心难题——签名计算(其实是个固定套路)

这是唯一稍微烧脑的地方,但这道菜的关键就是这个“签名”,防止别人乱喊你的音柱。芯步的规则是md5(md5(AppSecret) + ts)

通俗解释:先把你的“密码”(AppSecret)加密一次,然后加上当前的“时间戳”(ts),把这两个东西拼在一起,再加密一次,最后得到的字符串就是“签名”。

为什么要这样?因为时间戳一直在变,所以签名也一直在变,这样坏人很难伪造。

具体步骤(不管用什么编程语言,逻辑都一样):

  • Step 1Secret_MD5 = md5(AppSecret)

  • Step 2String_To_Sign = Secret_MD5 + ts (这里的ts就是当前的Unix时间戳,比如 1715678900)

  • Step 3Final_Sign = md5(String_To_Sign)

第三部分:开火!调用接口让音柱喊话

签名拿到了,咱们就开始“喊”它。芯步的接口非常友好,只需要往这个地址 POST 一段JSON数据就行了

1. 请求地址(URL):

注意:要把 {} 里面的内容替换成你实际的值。

2. 请求体(Body):这是一个JSON格式,告诉音柱:谁来喊、喊什么。

特别说明”play:gbk:16” 是固定的播报指令,其中16代表音量(0-9级,数字越大越响),后面的字符串就是你想要它发出的声音

第四部分:实战!给你一段Python示例代码

你不需要看懂所有代码,只要看逻辑。这里用通用的Python写,逻辑最清晰,你换成Java、Go、PHP都是一样的流程。

第五部分:进阶技巧——让你的反馈更“人性化”

光会喊话还不够,作为一个成熟的解决方案,你可以做得更贴心一点,芯步的接口也支持

  1. 调节音量和语速:如果是在安静的办公室,别吓着人,把音量调小点;如果是嘈杂的车间,直接拉满。

    • 音量调节命令:{“volume”: 5} (0-9级,5级适中)

    • 语速调节命令:{“speed”: 5} (0-9级)

  2. 区分紧急程度

    • 普通通知:“play:gbk:16”: “叮~ 有新的工单,请处理”

    • 严重报警:你可以先播报一个内置的警报音,再说话。比如先把音色切换成严肃的男声或者直接播放警示音,再念报警内容。

  3. 处理长文本和多音字:如果你要念很长的设备状态(比如一串长订单号),不用分割,设备端自动处理;如果遇到“重庆”被念成“重qing”,可以在接口里指定拼音。

总结

接这个音柱,你就记住三件事:

  1. 签名要算对,这是最常见的报错点。

  2. 设备ID要找对,别喊错对象。

  3. 要喊的话发过去,不要录音,只发文字,音柱自己会“读”出来。

按照上面的步骤,哪怕是只有一个简单的PLC触发电平信号,你中间写个几十行代码的小脚本,就能轻松实现设备状态“长嘴说话”。