芯步的智能语音台卡通过HTTP接口对接,可以在收款成功或失败时让台卡自动语音播报。下面说一下具体的操作流程。
一、准备工作
在写代码之前,需要先把下面的信息准备好:
注册账号:去芯步官网注册一个账号。
获取密钥:登录后进入控制台,在“开发设置”里找到 AppID(应用ID)和 AppSecret(开发者密码)。这两个是调用接口的凭证。
设备联网:给台卡插上USB电,用配网工具把它连上Wi-Fi。配网成功后,在后台能看到一个 设备ID(Device ID),下发指令全靠它。
二、核心对接逻辑
场景逻辑是这样的:顾客扫码支付 -> 支付服务器返回结果 -> 你的代码判断 -> 调用芯步接口 -> 台卡播报语音。
关键点在于:你的收银系统需要能拿到支付结果,然后由你的服务器去调用芯步的接口。 台卡本身不直接对接支付平台。
三、接入步骤(含代码示例)
芯步的接口很简单,就是标准的HTTP POST请求。签名生成规则是:md5( md5(AppSecret) + ts ),虽然有点绕,按步骤来就行。
第一步:生成签名(Sign)
第二步:封装播报指令
这是最核心的一步。我们需要定义“播报”这个动作,告诉台卡要说什么话。
比如支付成功时,可以播报“微信收款10元”,失败就播报“支付失败,请重试”。命令格式是 {"play:gbk:16": "你要说的话"}。
利用后台语言发送HTTP请求,下面是Python示例:
第三步:异常处理(失败播报)
支付失败的情况,逻辑和上面一样,改一下播报内容和音量就行。
四、实用小贴士
关于签名:签名里用了
ts(时间戳),主要是为了防止接口被恶意重放。记得每次请求都要实时生成,写代码时不要把ts写死。金额读音:芯步的语音引擎比较聪明,支持金额读法。传
"10.5"进去,它会自动读成“十元五角”,不需要你自己转中文。语速音色:除了播报,还可以发命令控制设备。比如加个
{"voice": 0}(0是女声,1是男声),或者{"speed": 5}调整语速。防止丢单:给台卡上一个铃声很有必要。比如支付成功时,先让它响一声提示音,再播报金额。命令大概是
{"ring": 1},具体看产品手册。
五、网络架构图
flowchart TD
A[顾客扫码支付] --> B[支付平台/服务器]
B --> C[你的收银/后端系统]
C -- 判断支付结果 --> D{支付成功?}
D -- 是 --> E[构造播报指令
"收款xx元"]
D -- 否 --> F[构造播报指令
"支付失败,请重试"]
E --> G[调用芯步开放接口
携带AppID, 签名, 设备ID]
F --> G
G --> H[芯步云平台]
H -- 通过网络推送 --> I[智能语音台卡]
I --> J[实时语音播报结果]总结
整个接入过程就是把“收银结果”转化成“语音文本”。你只需要按照上面的签名规则,在收到支付回调时,发一个HTTP请求给芯步的接口就行。这个方案延时很低,通常在300毫秒内就能响起来,对收银场景来说完全够用。