餐厅奶茶店叫号：怎么把智能场景联动语音台卡 2接入到项目中_解决方案

CATALOG

餐厅奶茶店的叫号场景中，传统方案往往需要部署独立的叫号屏、按键器或专用软件，成本高且灵活性差。芯步智能语音台卡2走的是“纯HTTP接口”路线——这意味着你现有的收银系统、小程序或排队软件，只需发一条网络请求，就能让它播报任意号码。以下是具体的集成方案。

解决方案：基于芯步智能语音台卡2的餐厅奶茶店智能叫号系统

1. 背景与需求分析

在餐厅和奶茶店的经营中，叫号环节经常面临“三叉戟”式困境：

环境嘈杂，听不见： 高峰时期，店员靠嗓子喊，后排顾客听不清。
系统割裂，操作烦： 人工叫号效率低，传统按键式叫号器线路复杂且易损坏。
成本与部署： 专业的LED叫号大屏价格昂贵，且需要布线施工。

芯步智能语音台卡2（UNI-YY-TK2） 恰好能解决这些问题。它本质是一台 Wi-Fi 语音播报终端，不需要网关，插上电就能用。核心思路是：让现有的收银软件或排队小程序，通过HTTP协议直接“遥控”这台设备说话。

2. 技术设计

核心原则： 由于台卡2开放标准的HTTP接口，它可以直接接收来自本地服务器或云端的指令，无需中间件。

接入层（现有系统）： 餐厅现有的点餐收银系统（Java/PHP/Python）、微信小程序/公众号、或简单的Web管理后台。
网络层（API）： 基于HTTPS的API请求。开发者只需计算签名（Sign），即可向设备下发指令。支持私有化部署，数据走内网，不经过外网，保障收银数据安全。
设备层（智能台卡2）： 放置在出餐口或前台。接收到指令后，高音量播报“请XX号取餐”，同时屏幕可滚动显示号码（视硬件屏幕规格而定）。

架构流程图：

graph TD
    A[收银/点餐系统] -->|1. 出餐/点击叫号| B(业务后端)
    B -->|2. 拼接API指令
生成MD5签名| C[芯步云API
或私有化部署服务器]
    C -->|3. 下发TTS语音指令| D[路由器/Wi-Fi]
    D -->|4. 无线推送| E[智能语音台卡2]
    E -->|5. 语音播报+屏幕显示| F[顾客听到叫号]

3. 核心对接步骤与代码示例

在对接过程中，开发者主要需要处理两个环节：设备配网 和 API下发指令。

3.1 设备初始化为“待命”状态

通电后，设备会发出热点信号。
使用“芯步”官方配网工具（或自己开发的配网模块），将设备的Wi-Fi模块连接至餐厅的2.4G Wi-Fi网络。设备支持设置5组备用Wi-Fi，确保网络稳定性。

3.2 调用HTTP接口下发叫号指令

这是集成的关键。智能语音台卡2的接口非常轻量，本质就是一个 POST 请求。

接口地址示例：POST https://api.thingboot.com/{AppID}/device/control/

请求头与鉴权：采用动态签名机制：

ts：当前时间戳。
signmd5( md5(AppSecret) + ts )。

Order命令参数：要实现叫号，我们主要使用 play:gbk:16 命令。假设需要叫号 “1025号，请用餐”。

示例代码：以下代码演示了如何在后端（如Node.js环境）调用接口。

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

// 配置参数 (从芯步控制台获取)
const AppID = "你的AppID";
const AppSecret = "你的AppSecret";
const DeviceID = "台卡2的设备ID"; // 类似 "1878"

// 生成签名
const ts = Math.floor(Date.now() / 1000);
// step1: md5(AppSecret)
const step1 = crypto.createHash('md5').update(AppSecret).digest('hex');
// step2: md5(step1 + ts)
const sign = crypto.createHash('md5').update(step1 + ts).digest('hex');

// 构造请求体
// 播报内容: TTS 文本，支持数字、金额、多音字
const orderCommand = {"play:gbk:16": "1025号，请用餐"};

async function callCustomer() {
    try {
        const response = await axios({
            method: 'POST',
            url: `https://api.thingboot.com/${AppID}/device/control/?sign=${sign}&ts=${ts}`,
            headers: {
                'Content-Type': 'application/json'
            },
            data: {
                device: DeviceID,
                order: orderCommand
            }
        });
        console.log("叫号成功:", response.data);
    } catch (error) {
        console.error("叫号失败:", error);
    }
}

// 执行叫号
callCustomer();

特别提醒：如果不方便写代码，也可以用 curl 命令直接测试
curl -X POST "https://api.thingboot.com/AppID/device/control/?sign=计算值&ts=时间戳" \ -H "Content-Type: application/json" \ -d '{"device":"设备ID","order":{"play:gbk:16":"188号，请取餐"}}'

4. 应用于餐厅/奶茶店的场景定制

不仅仅是简单的号码播报，利用API还可以实现更高级的智能场景联动

第一种场景：自动叫号（打通排队系统）

现状：顾客取号后，店员看着小票单号，手动按按钮。
改造后：顾客在小程序上取号排队。当轮到该号时，后台系统检测到叫号逻辑触发，自动调用API向台卡2发送指令，台卡精准报出该号码。无需店员操作，实现自动化。

第二种场景：分区叫号与二次提醒

需求：奶茶店常有“取茶”和“取餐”两个窗口。
实现：在软件中点选“张三的奶茶好了”，API下发指令：{"play:gbk:16":"请张三同学，到取茶口取餐"}。语音台卡支持TTS文本转语音，可以灵活拼接顾客昵称和饮品名，服务更贴心。

第三种场景：后厨联动

厨师出餐时，在后厨触屏电脑上点击“菜品完成”。后端调用API，前台的台卡2自动语音播报，实现后厨与前厅的物理联动。

5. 部署与运维

网络环境
- 请一定要使用 2.4G Wi-Fi（5G频段通常不被此类IoT设备支持）。
- 如果店内网络复杂，开启台卡2的 私有化部署 模式。配置自建MQTT/HTTP服务器地址，让设备只连接本地内网，杜绝因外网波动导致的叫号延迟。
音质与音量调节
- 高峰期环境嘈杂，可通过接口动态下发 {"volume":7} 指令，将音量调至最大。
- 非高峰期可调低音量，避免刺耳。
重试机制
- 在业务代码中，如果API调用超时或失败，应设置重试机制（例如间隔2秒重试3次），确保叫号不遗漏。

6. 总结

通过将 芯步智能语音台卡2 接入项目，餐厅和奶茶店能以极低的成本（仅需购买硬件，无需网关）和极简的开发量（仅需调用HTTP接口），实现专业级的叫号系统。

对开发者：接口签名逻辑简单，支持所有主流语言。
对商家：无需布线，插电即用，可随时更换位置，彻底解放店员嗓子，提升运营效率。