CATALOG

针对便利店的收银台场景,30W的音柱音量确实够用(比小喇叭洪亮很多),而且芯步的接口是通用的HTTP请求,不管你的收银系统是用C#写的、Java写的,还是网页版的,都能直接调通

下面我整理了一份傻瓜式接入方案,你可以直接发给开发人员看。

一、 咱们能实现什么样的效果?

接入之后,收银台的逻辑会变成这样:

  1. 扫码枪“滴”一声:顾客付款成功。

  2. 音柱立马响起来:不再是单调的“滴”,而是真人发声:“微信收款15元”或者“支付宝到账15元”。

  3. 异常提醒:如果支付失败或者没扫上,音柱直接播报:“支付失败,请重新扫码”。

  4. 营销引流:门口感应器触发,音柱播报:“欢迎光临,今天咖啡第二杯半价哦”。

关键是,这个30W音柱音量贼大,便利店再嘈杂,店员在后排货架补货也能听得清清楚楚。

二、 需要准备什么东西?

  • 硬件设备:芯步 30W 智能语音音柱(记得选对联网方式,店里WiFi信号好就选WiFi版,不稳定就选有线版)。

  • 网络环境:音柱需要联网(配置一次就行)。

  • 收银系统:只要你的收银电脑能上网,能运行代码(或者有网页接口),就能接。

三、 核心技术原理(大白话版)

这个对接一点都不复杂,原理就是一句话:你的收银软件在收到钱的那一刻,顺便往芯步的服务器发一条“短信”(HTTP请求),这条“短信”内容是“请播报:微信收款15元”,然后音柱就喊出来了。

  • 不需要 自己去录音、存文件。

  • 不需要 买声卡、插线。

  • 接口是纯文本传输,直接把汉字发过去,音柱内部自带芯片级TTS(语音合成),直接给你字正腔圆地读出来,而且是毫秒级响应

四、 详细对接步骤(开发者视角)

虽然不用代码附件,但咱们把逻辑和几个关键代码片段解释一下,开发人员一看就懂。

第一步:设备配网与注册

  1. 把30W音柱通电。

  2. 用手机App或者配置工具,把音柱连上店里的WiFi(或者插网线)。

  3. 在芯步的后台拿到属于这台音柱的唯一设备ID(相当于它的身份证号)和 AppID / AppSecret(你账户的钥匙)

第二步:搞懂怎么发指令

你需要向这个地址发送一个 POST 请求:

  • 请求地址http(s)://api.thingboot.com/{你的AppID}/device/control/

  • 必带参数(放在网址里):

    • sign签名。这是一个安全措施,为了防止别人乱发指令。计算规则是:md5( md5(你的密钥) + 当前时间戳 )

    • ts:当前时间戳。

  • 请求体(Body)(JSON格式):

    • device:刚才拿到的设备ID。

    • order:控制指令。

第三步:核心指令示例(让音柱说话)

这是最关键的一步。当你的收银系统检测到支付成功回调时,只需要执行类似下面的操作(以Java为例,其他语言类似):

怎么让声音更好听?你可以在播报文本里玩点花样:

  • 加提示音:在文本里加上[message_3],就会先响一声“叮咚”,再播报金额,吸引注意力。

  • 处理金额:数字直接写就行,引擎会自动读成“十五元”而不是“一五元”,如果你读“101元”怕听不清,可以在代码里加分隔,或者用接口参数调节语速语调

  • 男声/女声:除了默认女声,你可以加一条"voice":"1"指令切换成男声。

第四步:集成到收银系统的关键位置

你需要找到收银软件的支付成功回调函数,在那里面加上一段HTTP请求代码

逻辑伪代码:

五、 如果收银系统是外包的/不能改代码怎么办?

如果收银系统是买来的成品,不允许修改代码,也有办法:

  1. 搭一个“小桥接服务”:在你店里的一台电脑上(或者树莓派/路由器上),跑一个简单的脚本(比如Python脚本)。

  2. 监听数据库或日志:这个脚本去监控收银系统的数据库变化,或者监控打印端口的数据流。一旦发现新产生了“支付成功”的数据库记录,或者捕获到打印小票的数据,脚本就解析出金额,然后调用上面的API去控制音柱播报。

  3. 串口/并口监听:如果收银机连接了客显屏,也可以通过监听串口数据来判断金额。

这种方式不需要原收银软件厂商配合,是完全独立的一套语音系统。

六、 安装小贴士

  1. 位置:30W音柱虽然声音大,但最好别藏在收银台底下。把它挂在便利店的天花板角落,或者收银台上方的货架侧面,声音传播效果最好。

  2. 供电:记得预留220V电源插座。

  3. 网络:WiFi版的话,确保信号满格;如果是金属货架遮挡严重,直接上有线版,更稳定。

总结一下:这个方案就是发一条HTTPS请求的事。只要开发人员会curl或者HttpClient,30分钟就能调通。一旦接好,你的便利店瞬间就智能化了,店员再也不用扯着嗓子问“他付了吗”,效率提升一大截。