一、概述
在餐厅、奶茶店等餐饮场景中，叫号系统直接影响顾客体验和翻台效率。传统解决方案通常依赖专用收银设备或本地蓝牙音箱，存在播报内容单一、无法灵活对接订单系统、点位独立管理等痛点。
芯步15W智能语音壁挂音箱凭借开放的HTTP接口和云端TTS实时合成能力，可快速与现有收银系统、小程序点单后台或排队取号系统无缝对接，实现订单状态变更时的自动语音播报。
方案核心价值：
无需上传录音文件，接口推送文本即可实时合成语音
支持局域网与公网双模式，可私有化部署
毫秒级响应，从下单到播报仅需300ms左右
15W功率+双发声单元（2寸高音+4寸中低音），适合20-50㎡的餐饮空间
二、技术架构与接口特性
2.1 整体架构
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 软件项目层 │ │ 芯步云平台 │ │ 硬件设备层 │
├─────────────────┤ ├─────────────────┤ ├─────────────────┤
│ 收银系统/小程序 │─────▶│ API网关 │─────▶│ 15W壁挂音箱 │
│ 排队叫号后台 │ HTTP │ 签名验证/路由 │ MQTT │ (WiFi 2.4G) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │
│ ┌─────────────────────┐ │
└────────▶│ 私有化部署选项 │◀─────────────────┘
│ (自建消息服务器) │
└─────────────────────┘2.2 15W壁挂音箱核心能力
该设备在产品手册中明确标注支持以下开放能力
| 能力类别 | 命令示例 | 场景应用 |
|---|---|---|
| TTS文本播报 | {"play:gbk:16":"请A021号顾客取餐"} | 叫号核心功能 |
| 音量调节 | {"volume":"7"} | 根据时段自动调整 |
| 音色切换 | {"voice":"1"} | 男声/女声选择 |
| 语速调节 | {"speed":"5"} | 适应不同播报强度 |
| 铃声/提示音 | {"ring":"3"} | 叫号前吸引注意 |
| 停止播报 | {"stop":"1"} | 停止当前播报 |
设备支持5组WiFi网络预设，优先连接信号最强的接入点，确保网络稳定性。
三、接口对接详细步骤
3.1 前期准备
在对接之前，需要完成以下准备工作：
获取凭证：登录芯步控制台，在「开发设置」中获取
AppID和AppSecret设备配网：将15W壁挂音箱连接至门店WiFi（仅支持2.4GHz频段）
获取设备ID：在控制台查看设备列表，获取唯一
device标识网络规划：确认软件项目服务端可访问
api.thingboot.com（公网模式）或私有化部署地址
3.2 签名算法
所有HTTP请求需携带签名（sign）和时间戳（ts）进行身份验证，签名计算规则如下
// Step 1: 对AppSecret进行MD5加密
secret_md5 = md5(AppSecret)
// Step 2: 拼接时间戳（秒级），再次MD5
sign = md5(secret_md5 + ts)
// 示例:
// AppSecret = "abc123"
// ts = 1747212640
// sign = md5(md5("abc123") + "1747212640")注意：时间戳
ts需使用Unix秒级时间戳，签名有效期通常为5分钟，每次请求实时计算。
3.3 接口请求规范
请求地址：
POST https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}请求头：
Content-Type: application/json
请求体结构：
多设备广播示例：
3.4 代码示例
JavaScript/Node.js（Fetch API）
Java（Unirest）
cURL命令行测试
四、餐厅/奶茶店场景配置
4.1 叫号流程设计
顾客下单 ──▶ 订单系统生成排队号 ──▶ 后厨/吧台备餐
│
▼
备餐完成（状态变更）
│
▼
┌───────────────────────────────────────┐
│ 触发播报接口 │
│ ├─ 前置提示音:[ring_3] │
│ ├─ 文本内容:请A021号顾客取餐 │
│ └─ 可选:重复播报2次 │
└───────────────────────────────────────┘
│
▼
15W壁挂音箱播报
│
▼
┌────────┴────────┐
│ │
顾客取餐 超时未取
│
▼
二次提醒/过号处理4.2 播报内容模板设计
| 场景 | 播报模板 | 命令示例 |
|---|---|---|
| 普通取餐 | [提示音]请{号牌}号顾客取餐 | {"play:gbk:16":"[message_3]请A021号顾客取餐"} |
| 奶茶制作完成 | {号牌}号的奶茶已做好，请取餐 | {"play:gbk:16":"A021号的奶茶已做好，请取餐"} |
| 超时提醒 | {号牌}号餐品已准备好，请尽快取餐 | {"play:gbk:16":"A021号餐品已准备好，请尽快取餐"} |
| 过号处理 | {号牌}号已过号，请重新取号 | {"play:gbk:16":"A021号已过号，请重新取号"} |
| 欢迎语 | 欢迎光临+背景提示音 | {"play:gbk:16":"[ring_1]欢迎光临"} |
提示音类型：
[message_1]至[message_5]；铃声类型：[ring_1]至[ring_5]；警示音类型：[alert_1]至[alert_5]。
4.3 智能音量策略
不同时段应使用不同音量等级，避免干扰或听不清：
| 时段 | 音量值 | 说明 |
|---|---|---|
| 早餐高峰（7:00-9:00） | 7-9 | 环境嘈杂，需高音量 |
| 午餐高峰（11:30-13:30） | 8-9 | 最大音量 |
| 下午茶时段（14:30-17:00） | 4-6 | 适中音量 |
| 晚餐高峰（18:00-20:00） | 7-8 | 较高音量 |
| 临近打烊（21:00后） | 2-3 | 低音量，避免扰民 |
4.4 多区域部署方案
对于大型餐厅或多柜台门店，可通过设备分组广播实现分区叫号：
| 区域 | 设备ID | 播报范围 | 适用场景 |
|---|---|---|---|
| 取餐A区 | device_A01 | 1号出餐口 | 炸鸡/汉堡类 |
| 取餐B区 | device_B01 | 2号出餐口 | 饮料/甜品 |
| 排队等候区 | device_H01 | 大堂前区 | 叫号提醒 |
| 后厨 | device_K01 | 厨房内部 | 订单提醒 |
五、高级功能与优化
5.1 数字读法优化
芯步音箱支持智能数字读法识别，可区分数值、金额、手机号等
| 原文 | 期望读法 | 接口处理方式 |
|---|---|---|
123 | 一百二十三 | 自动识别为数值 |
12.5元 | 十二块五 | 带单位的金额 |
13800138000 | 一三八零零一三八零零零 | 手机号逐位播报 |
5.2 队列缓存与并发控制
高峰期（如午餐时段）叫号密集，需考虑请求队列管理：
5.3 断网重连与降级方案
设备支持5组WiFi预设，当主网络故障时自动切换。软件层也实现降级逻辑：
5.4 私有化部署（内网方案）
对网络隔离要求严格的场景（如内网收银系统），芯步支持私有化部署
自建消息服务器地址:http://{your-server-ip}:8080/{AppID}/device/control/配置方法：
在控制台申请私有化部署授权
部署官方提供的消息中间件至本地服务器
设备配置指向内网服务器地址
所有API调用切换至内网地址
六、注意事项
WiFi频段：设备仅支持2.4GHz WiFi，请确保门店路由器开启2.4G信号
签名时效：签名基于时间戳计算，在请求时实时计算，避免使用固定签名
播报长度：单次播报不超过100个中文字符，超长文本可能被截断
多设备管理：同一请求可向最多50个设备同时下发命令，使用逗号分隔device字段
电源要求：需DC 12V 2A电源供电，安装时注意电源适配器位置
安装高度：壁挂安装距离地面2-2.5米，朝向顾客等候区
通过上述方案，餐厅/奶茶店可在2小时内完成15W壁挂云音响与现有软件项目的对接，实现低成本、高可靠性的叫号语音播报系统。如有更多设备管理或API调用问题，可参考芯步官方产品手册和接口文档。