共享台球室的痛点是“人等人”：用户到店发现满台需干等，或空台闲置却无人使用。本文围绕芯步20W云语音音柱，设计了一套完整的叫号预约语音提醒方案——通过HTTP接口将音柱接入预约系统，实现用户到场、轮到号、超时预警等环节的自动语音播报。

解决方案：共享台球室叫号预约场景下的20W云远程语音音柱接入方案

一、 背景与需求分析

在共享台球室的运营场景中，痛点是“人”与“场”的调度效率。用户常常遇到到店后无空台、排队等待枯燥、或者轮到自己时因沉迷手机而错过上桌时间等问题。

为了提升无人值守/少人值守的智能化体验，我们需要将20W大功率云远程语音音柱接入现有系统，实现自动化、实时的语音叫号与预约提醒。

核心需求：

1. 到店签到提醒：用户扫码核销或开门时，播报欢迎语及台球桌号。

2. 排队叫号：当有空台释放时，通过音柱大音量通知下一顺位用户入位。

3. 预约/续费提醒：时间即将结束前，播报提醒用户续费或准备离开现场时。

4. 环境联动：接入人体传感器，检测到无人时自动播报引导。

二、 硬件选型：20W 云远程语音音柱

根据芯步的硬件参数，针对台球室普遍环境嘈杂、空间较大的特点，推荐选用 智能语音吸顶音箱|20W 或 智能语音音柱|10W/20W（视场地部署位置而定）。

关键特性分析：

• 大功率覆盖：20W功率足以覆盖台球室的击球声和背景音乐，确保叫号清晰。

• 文本直转TTS：无需预先录制MP3文件，通过HTTP接口直接推送文本（如“请A003号顾客到5号台打球”），音柱即时合成语音。

• 多网络接入：支持WiFi 2.4GHz 和 有线以太网，适应不同门店的网络环境（推荐使用有线，更稳定）。

• 开放接口：基于HTTP协议，使用简单的POST请求即可控制，对接小程序、SaaS后台极其方便。

三、 系统设计

整个方案采用 “ SaaS后台/小程序客户端 —— 芯步云平台 —— 20W语音音柱 ” 的架构。

1. 用户层：微信小程序（用户端）和 商户管理后台。

2. 业务逻辑层：共享台球室SaaS系统。负责处理订单状态、排队逻辑、计时计费。

3. IOT接入层芯步开放API。作为桥梁，接收业务系统的指令，并下发至硬件。

4. 执行层：部署在各个台球桌或等候区的20W云音柱。

工作流程示例：

用户A在手机端排队 -> 系统检测到3号台空出 -> 业务后端调用芯步API -> 携带参数 {"device":"810xxx", "order":{"play:gbk:16":"请A001号顾客到3号台打球"}} -> 等候区的20W音柱立即播报。

四、 接口接入步骤详解

要完成接入，开发人员需要进行以下步骤的操作：

第一步：设备配网与激活

• 将20W云音柱通电。

• 通过芯步商家端App或配网工具，将音柱连接至门店Wi-Fi（或插网线）。

• 在芯步开发者后台获取该设备的Device ID（设备唯一标识）。

第二步：获取API凭证

• 登录芯步开放平台，获取专属的 AppId 和 AppSecret。

第三步：发起一个HTTP请求（核心代码逻辑）芯步的接口采用签名验证机制，非常安全。在您的SaaS后端中，需要按照以下逻辑封装接口调用：

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

• Method： POST

• Body (JSON)

  { "device": "这里填写20W音柱的设备ID", "order": { "play:gbk:16": "这里是播报的文本内容" } }

• 签名算法

  1. 首先将 AppSecret 进行一次MD5加密，得到 secret_md5 = md5(AppSecret)。

  2. 将 secret_md5 拼接当前时间戳 ts，再整体做一次MD5：sign = md5(secret_md5 + ts)。

第四步：对接场景指令集在您的代码中封装好上述请求后，即可在任何业务节点调用。

场景A：排队叫号

• 触发时机：用户在小程序点击“排队取号”，且系统分配了排队号。

• 播报指令：{"play:gbk:16":"尊贵的顾客，您已排队成功，当前排队位置第5位，请留意叫号通知。"}

• 注意：可将音柱部署在等候区，音量调至80%。

场景B：轮到号了（空台分配）

• 触发时机：有顾客结账，系统将空闲球桌分配给排队用户。

• 播报指令：{"play:gbk:16":"请A001号顾客到3号台，请A001号顾客到3号台。"}

• 进阶设置：支持设置播放次数（需通过参数控制），重复播放2次，防止听漏。

场景C：倒计时提醒

• 触发时机：订单剩余时间 < 10分钟。

• 播报指令：{"play:gbk:16":"尊敬的顾客，您的打球时间还剩10分钟，如需续费请扫描桌上二维码。"}

场景D：传感器联动（防占座/防滞留）

• 配合智能人体存在雷达传感器：若检测到该台区无人，但订单仍在进行中（用户去上厕所/暂时离开），为避免资源浪费，可定时播报。

• 联动逻辑：雷达上报无人状态 -> 您的服务器接收消息 -> 触发音柱播报：“检测到暂无人打球，若您已离开现场时请点击订单结束，以便退还剩余押金”。

五、 项目实施与部署

1. 部署位置

   • 等候区：安装20W吸顶音箱，用于叫号，覆盖中远距离。

   • 吧台/过道：安装10W壁挂音箱，辅助提醒。

   • 台球桌正上方：不推荐安装过近的音柱（避免干扰玩家），装在墙壁两侧或休息区。

2. 音量与音色调试

   • 芯步接口支持实时调节音量（如 {"volume":70}）。在晚上22:00后自动将音量调低，避免扰民投诉。

   • 推荐使用女声，语调柔和但清晰，在嘈杂环境中辨识度更高。

3. 网络保障

   • 20W音柱虽然支持WiFi，但在商用场景中，2.4G频段干扰多。强烈使用支持“有线网口”版本的音柱，通过网线连接路由器，保证叫号不延迟。

六、 总结

1. 零改造：利用现有WiFi/有线网络，无需单独铺设音频线（区别于传统模拟广播）。

2. 高集成：通过芯步极简的 HTTP API，通常半天内即可完成排队系统与音柱的代码对接，大幅缩短开发周期。

3. 强覆盖：20W大功率，专为台球室此类底噪较高的娱乐场所设计，确保“喊得应”。

4. 智能化：从“人找球台”变成“球台通过语音找人”，提升翻台率和用户体验。