无人值守门店语音提示场景：如何将20W壁挂语音通知音箱集成到软件项目中_解决方案

CATALOG

一、概述

无人值守门店场景需要远程监控和语音交互能力——当顾客进店、自助结账、发生异常情况时，系统需要及时发出语音提示。芯步20W智能语音壁挂音箱（型号：UNI-YY-YX-BG-PRO-20W）通过开放HTTP接口实现远程语音播报，无需人工值守即可完成全流程语音交互。

核心能力

芯片级TTS：设备端完成语音合成，毫秒级响应
开放HTTP API：任意编程语言均可调用，10分钟完成对接
私有化部署：支持局域网直连，数据不出店
无网关设计：WiFi直连，即插即用

无人值守门店典型应用场景

场景	触发条件	语音内容示例
顾客进店欢迎	人体传感器检测到有人	“欢迎光临，自助购物请扫码进门”
自助结账引导	顾客扫码完成选购	“请将商品放入检测区，扫描付款码”
支付成功确认	支付接口回调成功	“支付成功，感谢惠顾，请带好您的商品”
异常行为告警	摄像头/传感器检测到异常	“请注意，店内区域请勿遮挡摄像头”
缺货提醒	货架传感器监测到商品不足	“补货提醒：A货架商品数量低于阈值”

二、产品核心特性

2.1 技术规格

特性	参数
产品型号	UNI-YY-YX-BG-PRO-20W
功率	20W（适合门店中大型空间覆盖）
外壳材质	铝合金，分隔式绝缘隔断
安装方式	壁挂式，可摆可挂
联网方式	WiFi 2.4GHz（可设定5组网络，自动切换）
控制接口	HTTP API
播报方式	文本转语音（TTS），芯片级合成
私有化部署	支持局域网直连，数据不出门店
响应延迟	80-120ms

2.2 支持的命令功能

功能类别	支持项	命令示例
文本播报	GBK编码文本	`{"play:gbk:16":"欢迎光临"}`
前置提示音	5种内置提示音	`{"play:gbk:16":"[message_1]新订单"}`
停止播报	打断当前播报	`{"stop":"1"}`
音量调节	0-9级	`{"volume":"7"}`
音色切换	男声/女声	`{"voice":"1"}`（0=女声，1=男声）
语速调节	0-9级	`{"speed":"5"}`
语调调节	0-9级	`{"tone":"5"}`
铃声播放	5种内置铃声	`{"ring":"1"}`
提示音	5种	`{"message":"1"}`
警示音	5种	`{"alert":"1"}`

数据来源：

三、软件集成架构

3.1 整体架构图

┌─────────────────────────────────────────────────────────────────┐
│                    无人值守门店管理系统                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  进店检测   │  │  支付系统   │  │  安防告警   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ HTTP API调用
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ WiFi 2.4GHz
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     20W壁挂语音音箱                              │
│                    （门店内壁挂安装）                             │
└─────────────────────────────────────────────────────────────────┘

3.2 集成工作流程

事件触发：传感器检测到顾客进入、支付完成、或系统检测到异常
文本生成：业务系统根据事件类型生成播报文本
签名计算：生成MD5签名，发起一个HTTP请求
指令下发：向API发送POST请求，携带设备ID和播报命令
语音播报：音箱接收命令，实时TTS合成并播放（80-120ms响应）

四、API接口接入详解

4.1 接口地址与签名计算

请求地址

https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

参数说明

参数	说明	示例
{AppId}	应用ID（控制台获取）	`qtyVWcgeMq`
{ts}	当前Unix时间戳（秒）	`1747212640`
{sign}	签名	`c484eb97...`

签名计算公式

sign = md5( md5(AppSecret) + ts )

将开发者密码（AppSecret）进行一次MD5，然后将结果拼接上时间戳，再对整个字符串做一次MD5

4.2 核心命令示例

4.2.1 基本文本播报

4.2.2 带提示音的播报

适用于重要通知，增强提醒效果：

注：[message_1]至[message_5]为内置提示音

4.2.3 紧急告警播报

适用于异常行为告警场景：

4.2.4 停止播报

4.3 多语言代码示例

Python

import requests
import time
import hashlib

class UnattendedStoreVoice:
    """无人值守门店语音播报控制器"""
    
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def _generate_sign(self, ts):
        """生成签名:md5(md5(AppSecret) + ts)"""
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def _send_command(self, device_id, order):
        """发送命令到设备"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {"device": device_id, "order": order}
        
        response = requests.post(url, json=payload)
        return response.json()
    
    def welcome(self, device_id):
        """进店欢迎播报"""
        return self._send_command(
            device_id, 
            {"play:gbk:16": "欢迎光临，自助购物请扫码进门，全程监控请放心选购"}
        )
    
    def payment_success(self, device_id, amount):
        """支付成功播报"""
        text = f"[message_1]支付成功，金额{amount}元，感谢惠顾"
        return self._send_command(device_id, {"play:gbk:16": text})
    
    def payment_failed(self, device_id):
        """支付失败提示"""
        text = "[alert_2]支付失败，请重新扫描付款码或选择其他支付方式"
        return self._send_command(device_id, {"play:gbk:16": text})
    
    def security_alert(self, device_id, alert_type):
        """安全告警"""
        alerts = {
            "tamper": "请注意，请勿遮挡监控设备",
            "unpaid": "请完成支付后再离开，谢谢配合",
            "emergency": "紧急情况已记录，工作人员正在处理"
        }
        text = f"[alert_1]{alerts.get(alert_type, alert_type)}"
        return self._send_command(device_id, {
            "play:gbk:16": text,
            "volume": "9"
        })
    
    def restock_reminder(self, device_id, shelf_id):
        """补货提醒"""
        text = f"系统提示:{shelf_id}货架商品数量低于阈值，请及时补货"
        return self._send_command(device_id, {"play:gbk:16": text})

# 使用示例
if __name__ == "__main__":
    # 初始化（替换为实际值）
    voice = UnattendedStoreVoice("your_app_id", "your_app_secret")
    device_id = "store_speaker_01"
    
    # 场景1:顾客进店
    voice.welcome(device_id)
    
    # 场景2:支付成功
    voice.payment_success(device_id, 45.80)
    
    # 场景3:异常告警
    voice.security_alert(device_id, "tamper")

Java

import kong.unirest.Unirest;
import kong.unirest.HttpResponse;
import org.apache.commons.codec.digest.DigestUtils;

public class UnattendedStoreVoice {
    private final String appId;
    private final String appSecret;
    
    public UnattendedStoreVoice(String appId, String appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
    }
    
    private String generateSign(long ts) {
        String md5Secret = DigestUtils.md5Hex(appSecret);
        return DigestUtils.md5Hex(md5Secret + ts);
    }
    
    public void broadcast(String deviceId, String text, Integer volume) {
        long ts = System.currentTimeMillis() / 1000;
        String sign = generateSign(ts);
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", 
            appId, sign, ts);
        
        Map<String, Object> order = new HashMap<>();
        order.put("play:gbk:16", text);
        if (volume != null) {
            order.put("volume", volume.toString());
        }
        
        Map<String, Object> payload = new HashMap<>();
        payload.put("device", deviceId);
        payload.put("order", order);
        
        HttpResponse<String> response = Unirest.post(url)
            .header("Content-Type", "application/json")
            .body(JSON.toJSONString(payload))
            .asString();
        
        System.out.println("播报结果: " + response.getBody());
    }
    
    public void welcome(String deviceId) {
        broadcast(deviceId, "欢迎光临，自助购物请扫码进门", 7);
    }
    
    public void paymentSuccess(String deviceId, double amount) {
        broadcast(deviceId, String.format("[message_1]支付成功，金额%.2f元，感谢惠顾", amount), 7);
    }
}

代码参考：

JavaScript/Node.js

const crypto = require('crypto');
const axios = require('axios');

class UnattendedStoreVoice {
    constructor(appId, appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.baseUrl = `https://api.thingboot.com/${appId}/device/control/`;
    }
    
    _generateSign(ts) {
        const md5Secret = crypto.createHash('md5').update(this.appSecret).digest('hex');
        const signStr = md5Secret + ts;
        return crypto.createHash('md5').update(signStr).digest('hex');
    }
    
    async sendCommand(deviceId, order) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.baseUrl}?sign=${sign}&ts=${ts}`;
        
        const payload = { device: deviceId, order };
        const response = await axios.post(url, payload);
        return response.data;
    }
    
    async welcome(deviceId) {
        return this.sendCommand(deviceId, { 
            "play:gbk:16": "欢迎光临，自助购物请扫码进门" 
        });
    }
    
    async paymentSuccess(deviceId, amount) {
        return this.sendCommand(deviceId, { 
            "play:gbk:16": `[message_1]支付成功，金额${amount}元，感谢惠顾` 
        });
    }
}

代码参考：

五、无人值守场景实战

5.1 第一种场景：进店欢迎与人流引导

需求：顾客扫码进门时自动播报欢迎语和使用指引。

设备配置：20W壁挂音箱 ×1（安装于入口处）+ 门磁/扫码器

5.2 第二种场景：自助收银语音引导

需求：顾客完成商品扫码后，引导完成支付流程。

设备配置：20W壁挂音箱 ×1（安装于收银区）

class CheckoutVoiceGuide:
    """自助收银语音引导"""
    
    def __init__(self, voice_controller, device_id):
        self.voice = voice_controller
        self.device_id = device_id
    
    def on_product_scanned(self, product_name, price):
        """商品扫码完成"""
        text = f"已添加{product_name}，金额{price}元，请继续扫描其他商品或点击完成购物"
        self.voice._send_command(self.device_id, {"play:gbk:16": text})
    
    def on_checkout_ready(self, total_amount):
        """购物完成，准备结账"""
        text = f"[message_2]购物完成，共计{total_amount}元，请打开付款码对准扫描区"
        self.voice._send_command(self.device_id, {"play:gbk:16": text})
    
    def on_payment_success(self, total_amount):
        """支付成功"""
        text = f"[message_1]支付成功，{total_amount}元，感谢惠顾，请带好您的商品"
        self.voice._send_command(self.device_id, {"play:gbk:16": text})
    
    def on_payment_failed(self):
        """支付失败"""
        text = "[alert_2]支付失败，请重新扫描付款码或选择其他支付方式"
        self.voice._send_command(self.device_id, {
            "play:gbk:16": text,
            "volume": "8"
        })

5.3 第三种场景：异常行为语音告警

需求：摄像头或传感器检测到异常行为时，立即发出语音警告。

设备配置：20W壁挂音箱 ×1 + 摄像头/传感器

5.4 场景四：缺货/补货语音通知

需求：智能货架监测到商品缺货时，向后台系统发送语音提醒。

设备配置：20W壁挂音箱 ×1（安装于后场/办公区）

5.5 场景五：闭店/值班状态切换

需求：营业结束时间自动播报提示；非营业时间检测到闯入时告警。

设备配置：20W壁挂音箱 ×1

5.6 场景六：与支付系统/小程序集成

需求：顾客通过小程序完成线上支付后，现场音箱自动提示。

六、私有化部署方案

无人值守门店对数据安全和稳定性要求较高，芯步音箱支持纯局域网运行。

部署模式对比

特性	公有云模式	私有化模式
设备联网	WiFi连接互联网	连接内网WiFi
API地址	`api.thingboot.com`	自建服务器IP
数据流向	经过芯步云端	内网直连，数据不出店
网络依赖	需要互联网	仅需局域网
适用场景	快速接入、单店	连锁门店、数据安全要求高

私有化配置要点

设备支持配置5组WiFi网络，自动连接信号最强的网络
需自建HTTP服务器接收设备状态回调
所有API调用在内网完成，延迟更低

七、设备安装部署指南

7.1 安装要求

项目	要求
安装方式	壁挂式，可摆可挂
安装位置	距地面2-2.5米，覆盖主要活动区域
电源	220V AC电源插座
网络	WiFi 2.4GHz信号覆盖良好
空间要求	门店面积50-200㎡1-2台

7.2 部署位置

门店类型	部署数量	安装位置
便利店（50-100㎡）	1-2台	入口1台，收银区1台
超市（100-200㎡）	2-3台	入口、收银区、货架区
无人货柜（10-20㎡）	1台	货柜上方

八、常见问题与排障

问题	可能原因	解决方案
设备不在线	WiFi信号弱	检查2.4GHz WiFi覆盖，设备支持5组网络自动切换
播报延迟高	网络波动	私有化部署可降至80-120ms
音量不够大	环境噪音大	调高volume至9，或考虑升级30W型号
多音字读错	TTS引擎规则	使用同音字替代，如“重量”改“重量（第四声）”
签名验证失败	参数错误	确认ts为秒级时间戳，签名公式为`md5(md5(AppSecret)+ts)`
无法同时播放	设备正在播报	使用`stop`命令停止当前播报后再发新命令

九、总结

本方案基于芯步20W智能语音壁挂音箱，实现了无人值守门店的全流程语音交互自动化

能力	实现的方式是
进店欢迎	门磁/人体传感器触发HTTP API播报
自助收银引导	支付系统Webhook驱动播报
异常行为告警	摄像头/传感器联动语音警告
缺货通知	货架传感器触发后场语音提醒
闭店/值班管理	定时任务自动切换播报模式

集成核心步骤

获取AppID/AppSecret，实现MD5签名算法
开发HTTP调用模块，封装各类场景播报函数
根据业务需求，在传感器事件/支付回调中调用播报接口

方案优势

✅ 接口统一：标准HTTP API，任意编程语言10分钟对接
✅ 即插即用：WiFi直连，无需网关
✅ 超低延迟：80-120ms响应，实时性强
✅ 功能丰富：支持音色/语速/音量调节，内置多种提示音
✅ 数据安全：支持私有化部署，数据不出店

如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。