CATALOG

芯步的智能语音台卡通过HTTP接口对接,可以在收款成功或失败时让台卡自动语音播报。下面说一下具体的操作流程。

一、准备工作

在写代码之前,需要先把下面的信息准备好:

  1. 注册账号:去芯步官网注册一个账号。

  2. 获取密钥:登录后进入控制台,在“开发设置”里找到 AppID(应用ID)和 AppSecret(开发者密码)。这两个是调用接口的凭证

  3. 设备联网:给台卡插上USB电,用配网工具把它连上Wi-Fi。配网成功后,在后台能看到一个 设备ID(Device ID),下发指令全靠它

二、核心对接逻辑

场景逻辑是这样的:顾客扫码支付 -> 支付服务器返回结果 -> 你的代码判断 -> 调用芯步接口 -> 台卡播报语音。

关键点在于:你的收银系统需要能拿到支付结果,然后由你的服务器去调用芯步的接口。 台卡本身不直接对接支付平台。

三、接入步骤(含代码示例)

芯步的接口很简单,就是标准的HTTP POST请求。签名生成规则是:md5( md5(AppSecret) + ts ),虽然有点绕,按步骤来就行

第一步:生成签名(Sign)

第二步:封装播报指令

这是最核心的一步。我们需要定义“播报”这个动作,告诉台卡要说什么话。

比如支付成功时,可以播报“微信收款10元”,失败就播报“支付失败,请重试”。命令格式是 {"play:gbk:16": "你要说的话"}

利用后台语言发送HTTP请求,下面是Python示例:

第三步:异常处理(失败播报)

支付失败的情况,逻辑和上面一样,改一下播报内容和音量就行。

四、实用小贴士

  1. 关于签名:签名里用了 ts(时间戳),主要是为了防止接口被恶意重放。记得每次请求都要实时生成,写代码时不要把 ts 写死

  2. 金额读音:芯步的语音引擎比较聪明,支持金额读法。传 "10.5" 进去,它会自动读成“十元五角”,不需要你自己转中文

  3. 语速音色:除了播报,还可以发命令控制设备。比如加个 {"voice": 0}(0是女声,1是男声),或者 {"speed": 5} 调整语速

  4. 防止丢单:给台卡上一个铃声很有必要。比如支付成功时,先让它响一声提示音,再播报金额。命令大概是 {"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毫秒内就能响起来,对收银场景来说完全够用。