培训场景的语音播报看似简单，实则有两个痛点：一是金额动态变化，无法预录；二是需要与上课、下课、收款等多个触发事件联动。以下方案基于芯步开放接口，通过动态文本合成技术实现自定义金额的实时播报。

1. 背景与需求分析

在现代化的教育培训机构中，上课下课提醒以及课中临时缴费（如资料费、活动费、续费）的播报通常依赖人工喊话或传统铃声，缺乏灵活性和数字化衔接。本方案的目标是利用芯步的智能语音硬件及开放接口，解决以下三大痛点：

1. 金额自定义：缴费场景中，收款金额是变量，系统需实时生成“微信/支付宝收款XX元”的语音。

2. 事件联动：将排课系统中的签到、结课动作自动映射为物理硬件的指令。

3. 无人化值守：教务人员无需进入教室，通过后台或系统逻辑自动触发语音提醒。

2. 系统架构

本方案采用“业务系统（培训CRM/ERP） + 芯步开放平台 + 智能硬件终端”的三层架构。

• 感知/执行层：部署在教室内的芯步智能语音喇叭（如智能语音喇叭3或Mini系列）。

• 网络接入层：设备通过Wi-Fi或4G接入物联网云端，接收MQTT/HTTP指令。

• 平台与业务层

  • 芯步开放平台：负责设备鉴权、状态管理、指令下发。

  • 培训机构业务系统：包含排课模块、收银模块。通过调用芯步API，实现“业务事件”向“硬件动作”的转化。

3. 核心实施步骤：自定义金额语音播报

该场景主要解决学员缴纳小额费用（如教材费30元）或课程续费时的现场播报，确保工作人员和学员双方都能确认到账与金额。

3.1 硬件选型与准备

推荐使用 智能语音喇叭3。该设备支持通过HTTP接口直接推送文本进行TTS（文本转语音）播报，无需预录录音，支持数字金额的自然语言读法，且支持extra字段携带业务流水号以防止重复播报。

3.2 接口对接逻辑

当收银员在前台完成一笔收费（或学员扫码支付成功）时，业务系统需触发播报请求。

关键接口：设备控制 - 向设备下发指令

• 请求地址https://api.thingboot.com/{AppID}/device/control/？sign={sign}&ts={ts}

• 核心参数构造

  • device：填写目标教室的语音喇叭设备ID（如"12345678"）。

  • order（关键）：此参数决定了播报内容。对于金额播报，命令结构如下：

  { "order": { "play:gbk:16":"[msg_3]支付宝收款{amount}元"， "extra":"BIZ_ORDER_20231027_001" // 传入订单号防止重放攻击 } }

  技术解析play：gbk：16是语音播报专用指令；系统会将{amount}动态替换为实际数字，如“30”，喇叭会自动识别为“三十元”。[msg_3]代表播报前播放一个提示音，起到收银台警戒作用。

3.3 金额精度与防重复机制

• 金额精度处理：对于带有角分的金额（如29.9元），在业务端将数字格式化为标准字符串再下发。芯步的TTS引擎对数字读法有优化，支持“二十九点九元”的自然朗读。

• 调用机制处理：利用extra字段。如果网络抖动导致接口重试，同一订单号再次下发时，硬件或云端可根据extra进行去重，避免在30秒内重复播报同一笔收款。

4. 第二种场景：上下课语音提醒的定制化配置

除了金额，常规的上下课提醒也需要替代传统电铃。

4.1 定时任务触发

在培训管理系统中，通常会设定每节课的时间表（例如：9：00上课，10：30下课）。系统需通过后台定时任务调用接口。

• 上课提醒：提前1分钟或准点播报。

  • 指令示例{“play：gbk：16”：“同学们好，现在开始上课啦，请把手机调至静音。”}

• 下课提醒

  • 指令示例{“play：gbk：16”：“下课时间到了，请同学们带好随身物品。另外，提醒张三同学请补交一下资料费。”}（该场景可对接欠费名单）

4.2 音量与环境适配

培训教室可能存在大小班之分，芯步接口支持远程调节音量。

• 上课高峰期（人员嘈杂）：音量调至7-9（高）。

• 午休或自习课：音量调至2-3（低）。

• 控制指令{“volume”：“5”}。

5. 进阶联动：签到即播报（人体传感器联动）

为了实现更智能的“人到即播报”，方案可引入芯步的智能人体存在传感器。

1. 配置联动：在芯步控制台设置联动规则。当传感器检测到有人进入（雷达感应），触发语音喇叭播报“欢迎光临XX培训，请到前台签到”。

2. 自定义签到播报：结合HTTP API，当学员刷卡或扫码签到时，业务系统直接向该教室喇叭下发：{“play：gbk：16”：“{name}同学已签到，本次课程剩余{balance}节。”}。这利用了设备的高响应速度（命令下发至设备响应约80-120ms）。

6. 实施中的关键注意事项

6.1 签名机制与安全

芯步接口采用严格的鉴权，必须计算Sign。

• 算法Sign = MD5( MD5(AppSecret) + ts )。

• 注意：在Java或Node.js集成时，请一定要对order内的JSON字符串进行转义。错误的转义是导致code 502（设备不存在）之外最常见的失败原因。

6.2 异步处理与结果确认

API返回code 200仅代表指令到达云端，不代表设备已播放。对于必须听到声音的关键场景（如大额收款），：

1. 订阅芯步的消息推送服务。

2. 接收设备执行后的回调（如播放成功或离线失败），以此作为业务系统中“播报完成”的凭证。

6.3 多教室并发管理

大型机构拥有多个教室，在业务系统中维护一个“设备池”。

• 根据上课班级自动匹配device_id。

• 避免向空闲教室发出收款指令，造成混乱。

7. 方案效益评估

通过引入芯步的开放接口与智能硬件，培训教室可以实现：

1. 财务透明化：收款语音播报减少了当面点钞或口头确认的尴尬，利用extra字段关联订单，实现账目与设备日志的比对。

2. 人员效率提升：教务无需挨个教室通知临时事务，通过API批量下发指令至指定设备，实现远程通知。

3. 数字化体验：将传统的模拟信号铃声升级为基于数字TTS的高定制化语音，提升了培训机构的专业化形象。

总结：该解决方案的核心在于利用芯步play：gbk：16指令的动态文本能力，结合业务系统的定时任务与支付回调，实现了培训教室场景下“自定义金额”与“课表时间”的完美语音闭环。