CATALOG

芯步智能语音台卡开放HTTP接口,支持通过API直接下达TTS指令。以下方案将说明如何利用这一接口,将任意金额动态传入播报命令,实现“传入多少、播报多少”的二次开发。

解决方案:基于芯步智能语音台卡实现自定义金额语音播报

1. 核心原理概述

芯步智能语音台卡开放了标准的 HTTP API 接口。二次开发的核心逻辑是:外部系统(如收银软件、手机App、网页)在支付流程完成后,将实时的“订单金额”作为参数,动态拼接到语音播报指令中,通过HTTP请求发送给设备,设备接收到指令后立即进行TTS(文字转语音)播报

整个流程无需人工预设金额,全自动实时生成。

2. 准备工作

在开始开发前,需要准备以下三项关键信息:

  1. 硬件设备:芯步“智能语音台卡2”(确保已通电并连接Wi-Fi)。

  2. 平台凭证

    • AppID:应用唯一标识。

    • AppSecret:开发者密码(用于接口签名加密)。

    • Device ID:台卡的设备编号(可在控制台查看)

  3. 网络环境:确保开发服务器能访问公网(如果使用私有化部署方案则需配置局域网环境)。

3. 技术对接流程

整个二次开发分为三个步骤:设备配网、签名计算、接口调用。

3.1 设备配网

通过芯步控制台为设备配置Wi-Fi:

  • 登录芯步工作台,进入“物联网控制台” -> “网络配置”。

  • 添加现场的2.4G Wi-Fi名称和密码。

  • 将台卡置于配网模式,通过手机热点或扫码完成网络同步

3.2 接口签名计算

芯步的接口采用动态签名验证,防止接口被恶意调用。签名算法规则如下:Sign = md5( md5(AppSecret) + ts )

  • ts:当前时间戳(Unix时间戳,秒级)。

  • 运算逻辑:先将AppSecret进行MD5加密得到字符串S1,再将S1拼接上时间戳ts得到字符串S2,最后对S2整体进行MD5加密得到最终的Sign

注:时间戳需与签名计算时使用的时间戳保持一致。

3.3 下发播报指令

这是实现“自定义金额”的关键步骤。我们需要构建一个包含金额变量的order指令。

  • 请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

  • 请求方式:POST

  • 请求头Content-Type: application/json

  • 请求Body参数

重点解析{动态金额} 是需要你在代码中动态替换的变量。例如,用户支付 135.74 元,你的后端代码应将{动态金额}替换为135.74,最终形成的字符串为:“微信收款135.74元”

高阶优化如果你需要更专业的语音效果(比如金额数字读法更标准),可以结合芯步平台内置的TTS增强功能,调整语速、音色,或者利用SSML标记语言来控制金额数字的读法

4. 代码实战示例

以下提供几种常见的二次开发语言对接示例,核心逻辑为“拼接待播报的金额字符串”:

Python 示例(适用于后端)

Javascript / Node.js 示例(适用于Web或云函数)

5. 二次开发的高级集成场景

除了简单的金额替换,你还可以结合业务逻辑做更深入的二次开发:

  1. 对接主流收银系统在市面上常见的收银软件(如思迅、美萍等)的“支付完成”钩子函数中,加入HTTP请求代码。当软件检测到收款成功时,自动截取订单金额并调用上述API

  2. 多维度语音定制

    • 渠道区分:根据支付类型(微信/支付宝/现金),修改播报前缀,例如order指令中的文本变为“支付宝到账XX元”。

    • 金额校验:TTS对于“135.74”可能会读成“一百三十五点七四”,你可以通过后端逻辑先将金额转换为“一百三十五点七四元”再传给设备,或者依赖设备自带的金额数字优化读法

  3. 事件联动(如灯光/屏幕)虽然台卡主要功能是语音,但其接口通常也支持屏幕显示变化。你可以二次开发,在播报金额的同时,下发指令让台卡屏幕显示收款码或交易成功的提示界面,实现“声画同步”

6. 关键注意事项

  1. 编码格式:播报的中文字符串必须使用UTF-8编码,否则设备端会播报乱码或无声

  2. 网络延迟:常规公网调用延迟在80-120ms左右,属于正常范围。如果需要极速响应(如地铁闸机场景),咨询芯步技术支持开启私有化部署或局域网直连模式

  3. 频率限制:虽然接口没有严格意义上的公开限流(视套餐而定),但在高并发场景(如大促收银台)下,在代码中加入去重机制(例如同一笔订单短时间内只触发一次),防止重复请求造成设备播报堆积

  4. 多音字处理:如果店名或特定的活动名称有多音字,可以在TTS文本中用同音字替换,或者查阅芯步的SSML标记文档进行标注

通过以上方案,你可以快速将芯步智能语音台卡深度集成到自己的商业软件或支付系统中,实现完全自定义的动态金额语音播报。