一、概述
在需要语音通知、语音提醒或语音警报的场景中（如生产线异常播报、仓库作业指令、办公区广播通知等），芯步的10W壁挂语音通知音箱提供了标准化的HTTP开放接口，可通过简单的API调用实现文本到语音的实时播报。
音箱型号：UNI-YY-YX-BG-LAN-10W（有线网版）核心优势：无需上传录音、无需后台配置、只需推送文本即可播报、支持私有化部署
二、集成架构
┌─────────────────┐ HTTP/HTTPS ┌─────────────────┐
│ 业务系统 │ ──────────────────▶ │ 芯步开放平台 │
│ (ERP/OA/自研) │ │ api.thingboot.com │
└─────────────────┘ └────────┬────────┘
│
│ 设备下发命令
▼
┌─────────────────┐
│ 壁挂语音音箱 │
│ (10W有线版) │
└─────────────────┘工作流程
业务系统发起HTTP请求，携带设备ID和播报内容
平台验证签名后，将命令下发给指定音箱
音箱实时以TTS（文字转语音）方式播报
三、准备工作
3.1 获取凭证
登录芯步开放平台，获取以下信息
| 参数 | 说明 | 示例 |
|---|---|---|
| AppId | 应用唯一标识 | qtyVWcgeMq |
| AppSecret | 开发者密码 | 用于签名计算 |
| 设备ID(device) | 音箱唯一编号 | 1878 |
3.2 网络要求
有线网版：需为音箱接入网线，确保其与开放平台网络互通
支持纯局域网私有化部署，可自建消息服务器
四、接口集成详解
4.1 请求地址与签名计算
请求地址
POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}签名算法（两步MD5）
sign = MD5( MD5(AppSecret) + ts )
ts：当前Unix时间戳（秒）+：字符串拼接
签名计算示例（Python）：
4.2 请求体格式
以JSON格式发送，包含device和order两个字段
| 字段 | 类型 | 说明 |
|---|---|---|
| device | String | 音箱设备ID，多个设备用逗号分隔 |
| order | Object | 命令对象，key为命令名，value为命令参数 |
4.3 核心命令列表
10W壁挂音箱支持以下命令
| 命令 | 格式示例 | 说明 | 参数范围 |
|---|---|---|---|
| 文本播报 | {"play:gbk:16":"内容"} | TTS实时播报 | 文本长度≤200字 |
| 音量控制 | {"volume":7} | 设置播放音量 | 0（静音）~9（最大） |
| 音色切换 | {"voice":1} | 男声/女声切换 | 1=女声，2=男声 |
| 语速调节 | {"speed":5} | 调节播报语速 | 0~9（0最慢，9最快） |
| 语调调节 | {"tone":5} | 调节音调高低 | 0~9 |
| 铃声播放 | {"ring":1} | 播放预设铃声 | 1~5 |
| 提示音 | {"message":1} | 播放提示音 | 1~5 |
| 警示音 | {"alert":1} | 播放警示音 | 1~5 |
| 停止播报 | {"stop":1} | 立即停止当前播报 | 1 |
4.4 完整请求示例
Python + requests 实现
五、典型应用场景集成示例
5.1 第一种场景：订单提醒（餐饮/零售）
当系统产生新订单时，自动语音通知厨房或取餐区。
业务流程
用户下单 → 订单系统保存 → 触发播报接口 → 音箱播报"您有一个新的外卖订单"
代码集成点（订单创建回调中）：
5.2 第二种场景：设备告警（工业/物联网）
配合传感器使用，当监测到异常时立即语音告警。
联动示例（温湿度传感器触发）：
5.3 第三种场景：排队叫号（服务大厅）
集成到排队系统中，叫号时语音通知客户。
业务流程
取号 → 叫号（柜员点击）→ 系统调用播报 → "请A001号到3号窗口办理"
5.4 场景四：车辆调度（物流/停车场）
根据车辆进出状态自动播报调度指令。
六、进阶功能
6.1 批量播报（多设备同时）
在device参数中用逗号分隔多个设备ID：
6.2 队列播报
连续下发多条命令时，音箱会自动排队依次播放，不会互相打断。
6.3 数字读法优化
系统智能识别数字类型，自动选择正确读法：
123→ “一百二十三”13800138000→ “一三八零零一三八零零零零”（手机号逐位读）100.50元→ “一百点五元”
6.4 多音字处理
通过调整tone（语调）参数可改善多音字发音准确度。
6.5 私有化部署
若需纯局域网环境运行，可自建消息服务器，平台支持完整的私有化部署方案。
七、常见问题与
| 问题 | 解决方案 |
|---|---|
| 播报延迟较大 | 检查网络环境，有线版使用静态IP；延迟通常为80-120ms |
| 签名验证失败 | 检查AppSecret是否正确、时间戳是否为整数秒 |
| 设备离线 | 确认音箱电源和网络连接，有线版检查网口指示灯 |
| 播报内容被截断 | 单次文本不超过200字，长文本可分多次发送 |
| 音量不合适 | 先调用volume命令设置音量，再播报内容 |
八、总结
芯步10W壁挂语音通知音箱通过标准的HTTP接口，使开发者能够在30分钟内完成从零到可用的集成。整个集成过程仅需三步：
注册平台，获取AppId、AppSecret和设备ID
实现签名计算，调用播报接口
嵌入业务逻辑，在触发点调用接口
该方案适用于各类需要语音提醒的场景，具备低延迟、高稳定性、支持私有化部署等特点，可快速提升系统的交互能力和通知效率。