CATALOG

芯步的智能语音台卡2开放了HTTP接口,核心思路就是通过一条API指令,直接让设备“说出”你想要的任何内容。下面按步骤拆解一下具体怎么实现自定义语音模板。

1. 打好底子:准备工作

在开始写代码之前,你需要先搞定三样东西,就像做菜先备料一样:

  1. 拿到钥匙(AppID 和 AppSecret)

    • 先去芯步官网注册账号,登录后进到“控制台”。

    • 在“开发设置”里,你会看到一串叫 AppIDAppSecret 的东西。这俩就是你的专属密钥,待会儿发命令必须带上

  2. 认识你的设备(Device ID)

    • 把“智能语音台卡2”连上WiFi(它只支持2.4G网络)。

    • 在控制台的设备列表里,找到这台设备,复制它的 Device ID(通常是一串数字,比如 1878

  3. 了解接口地址

    • 所有的控制指令,都要发送到这个“大本营”:

    • https://api.thingboot.com/{你的AppID}/device/control/

2. 核心玩法:安全签名机制

芯步的接口很看重安全,为了防止别人乱发指令给你的设备,它搞了一个“加密码”的算法。你并不需要完全搞懂原理,只需要照着公式算就行

签名生成公式(也就是代码里的那一行):Sign = md5( md5(AppSecret) + 当前时间戳 )

用人话翻译一下:把你那一长串 AppSecret 进行第一次MD5加密,然后拼接上当前的时间戳,最后再整体做一次MD5加密

注意:时间戳是Unix时间戳(秒数),比如 1747212640。后端会用同样的算法算一遍,对上了才让你发指令。

3. 灵魂所在:自定义语音模板设置

这就是你要的重头戏了。想要让台卡播报你定制的文案,核心在于 order 参数里的 play 命令。

基础模板:让设备开口说话

只要你算好了签名,只要通过一行 curl 命令(或者在Postman里操作)就能搞定。

示例场景: 让台卡说“欢迎光临,里面请”。下面这段代码你可以直接复制,把里面的“开发者ID”、“开发者密码”、“设备ID”换成你自己的就行:

只要返回的是成功的状态码,你的台卡立马就会喊出“欢迎光临,里面请”

升级模板:拼接音效 + 调节状态

如果你的“自定义”不仅仅是文字,还想加点前奏(比如“叮咚”声),或者调大音量,那就需要用到组合指令了。

1. 带提示音的模板台卡内置了5种提示音(比如开门铃声)。命令示例{"play:gbk:16":"[message_1]你好,新订单请及时处理"}这里的中括号里写 message_1message_5,就会先“叮咚”一声再说话

2. 调音量的模板(前置设置)如果你想确保每次播报的音量都是最大,可以先发一条音量指令。命令示例{"volume":"9"} (音量范围0-9,数字越大声音越大)

3. 完整的一次“自定义播报”流程你可以把这些操作串起来:

  • 第一步(调音量)order='{"volume":"9"}'

  • 第二步(播报)order='{"play:gbk:16":"[message_3]金牌客户,这边请"}'

4. 避坑指南与小贴士

在实际操作中,有两点小提醒:

  • 关于“自定义”的编码:芯步的设备内置了语音合成芯片,你不用上传录音文件。只要传入中文、数字、英文,它会