便利店收银台语音提示场景：怎么把10W 物联网语音广播音箱接入到自己的项目中_解决方案

CATALOG

芯步10W语音广播音箱接入方案：便利店收银台语音提示场景

一、这个场景能解决什么问题？

先说说便利店的痛点吧：收银员忙起来的时候，眼睛盯着商品扫码，手忙着找零，耳朵还得竖着听手机里那一声“微信支付到账XX元”。手机声音小了听不见，手机离远了还是听不见，尤其到了饭点高峰期，收银台乱成一锅粥，漏单、逃单的情况时有发生。

芯步这款10W的物联网语音广播音箱，就是来解决这个问题的。它能直接连WiFi，你只需要通过接口推送文本，它就能“开口说话”，而且是真人发音，音量足够覆盖整个便利店。更重要的是，它有个开放接口，可以直接接到你的收银系统里。

二、整体长啥样？先认识一下这台设备

这台10W音柱不大，大概104mm宽、260mm高，铝合金外壳，白色，看着挺简洁的。它支持WiFi 2.4GHz连接，接上12V电源就能用。

关键点是：不需要上传录音，不需要在后台预先设置什么模板。你传文字，它就播文字，实时生效。

三、怎么接到你的项目里？核心步骤

第一步：设备配网，让它连上WiFi

这个一般在芯步的官方App或者小程序里操作，按提示把设备配上网。配好之后，在控制台里能看到这台设备的唯一ID（就是一串数字或者字母组合），记下来，后面要用。

第二步：拿到接口密钥

去芯步开放平台注册一个开发者账号，创建你的应用。你会拿到两个东西：AppID和AppSecret。这两个相当于你的“账号密码”，调用接口的时候用来做身份验证。

第三步：搞明白签名怎么算（这一步稍微有点绕，但一次写对就能一直用）

芯步的接口用了签名验证，防止被人乱调用。签名算法是这样的

解释一下：

先把你的AppSecret做一次MD5加密，得到一个32位的字符串；
把这个字符串和当前的时间戳ts（单位是秒）拼在一起；
把拼好的字符串再做一次MD5，得到最终的sign。

举个例子，假设你的AppSecret是abc123，当前时间戳是1747212640
MD5(abc123) = 202cb962ac59075b964b07152d234b70
拼接：202cb962ac59075b964b07152d234b70 + 1747212640 = 202cb962ac59075b964b07152d234b701747212640
MD5(上面那一长串) = 这就是你的sign

第四步：调用接口让它说话

接口地址格式是：

请求体（JSON格式）长这样：

其中{"play:gbk:16":"你想播的文字"}就是让音箱播报的命令。

第五步：和你的收银系统打通

这个才是重头戏。你需要在你现有的收银系统里找个地方“埋”一段调用代码。

举个例子，如果你是Java写的收银系统，伪代码大概是这样

其他语言也类似，核心就是往那个接口发一个HTTP POST请求。支不支持Python/Go/PHP？都支持，只要是能发HTTP请求的语言就行。

四、代码示例（以Java为例）

给一段能直接改改用的代码：

import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpUtil;
import cn.hutool.crypto.digest.DigestUtil;

public class YoyoBroadcast {
    
    private static final String APP_ID = "你的AppID";
    private static final String APP_SECRET = "你的AppSecret";
    
    public static void broadcast(String deviceId, String text) {
        long ts = System.currentTimeMillis() / 1000;
        // 计算签名
        String md5Secret = DigestUtil.md5Hex(APP_SECRET);
        String sign = DigestUtil.md5Hex(md5Secret + ts);
        
        // 构造URL
        String url = "https://api.thingboot.com/" + APP_ID + "/device/control/?sign=" + sign + "&ts=" + ts;
        
        // 构造请求体
        String body = "{\"device\":\"" + deviceId + "\",\"order\":{\"play:gbk:16\":\"" + text + "\"}}";
        
        // 发送请求
        String result = HttpRequest.post(url)
                .header("Content-Type", "application/json")
                .body(body)
                .execute()
                .body();
        
        System.out.println("播报结果:" + result);
    }
    
    // 在支付成功的地方调用
    public static void onPaymentSuccess(double amount) {
        broadcast("你的设备ID", "支付宝到账" + amount + "元");
    }
}

上面用了Hutool工具库简化代码，你也可以用原生的HttpURLConnection或者OkHttp，都行。

五、一些实用

1. 关于文字内容：直接传中文就行，接口会自动合成语音。支持金额、手机号等数字的智能读法，比如“15.5元”会读成“十五块五”。

2. 关于并发：放心，高峰期同时收好几笔款，按顺序调用就行，音箱会把每一笔都念出来，不会丢。

3. 关于音量：支持远程调节音量。可以在order里加参数调整，也可以去App里设默认值。

4. 关于断网：设备断网了会播不了，不过这是所有网络音箱的通病。收银系统做个兜底，比如调用接口时判断一下音箱是否在线，不在线就回退到手机播报。

5. 关于多设备：一个店里可能收银台一个，仓库一个，门口一个。支持一个请求同时发给多个设备，device参数里用逗号隔开就行。

六、小结

总结一下整个流程：

买设备 → 2. 配网拿设备ID → 3. 注册开发者账号拿AppID/AppSecret → 4. 在你的收银系统里调用HTTP接口 → 5. 搞定。

最难的部分其实就是算签名那一行代码，写对了一次之后就不用管了。芯步的接口设计得很简单，没有复杂的SDK、没有长连接维护、也不需要上传录音文件，就是一个纯HTTP请求，对开发者非常友好。

如果你用的是现成的收银SaaS软件，可能需要在它的“扩展脚本”或者“Webhook”功能里配置这个接口调用，具体得看你用的什么收银系统。如果收银系统是外包开发的，直接把这段代码交给开发就行，他们一看就明白。