云端下发文本,设备用 TTS 播报(系统引擎:Windows SAPI / macOS/iOS AVSpeech / Android TTS;另可选内置离线引擎 sherpa,首次启用时下载约 51MB 模型)。多条播报按先进先出排队依次播放。
命令样例
字段说明
| 字段 | 说明 |
|---|---|
| text | 播报文本。入队先进先出;队列上限 20 条 |
| repeat | 单条连播次数(默认 1,上限 99),播够次数才轮到下一条 |
| lang | 语言(zh/en),缺省跟随系统语言 |
| volume | 0~100,默认 60 |
| rate | 语速倍率 0.5~2.0,默认 1.0 |
| engine | 引擎选择:system(系统 TTS)/ sherpa(内置离线引擎,断网可用) |
| stop / pause / resume / clear | 队列控制:stop 停当前条目、pause 暂停、resume 恢复、clear 停止并清空 |
参数生效范围:播放命令(带 text)携带 lang/volume/rate 时仅本条生效;无 text 的纯设置命令才更新并持久化(同步到云端配置项 speech_lang/speech_volume/speech_rate)。
应答与进度上报
- 立即应答:成功
{"ret":"ok"};队列满queue full;无可用 TTS 引擎engine not ready;参数非法invalid param: ... - 进度上报(异步,order/client,携带原 mid):条目开始
{"state":{"status":"1"},"progress":"1/2"};条目完成{"state":{"status":"0"},"progress":"2/2"};被 stop/clear 终止的条目不上报
注意事项
- 语音播报与显示区域无关,作用于整台设备
- 适合到店欢迎、整点提醒、告警提示等场景;连续高频下发时注意队列积压(上限 20)
- 页面内也可以用
SS.speech(text)本地播报(仅插件本地托管页开放,不产生云端消息,见《插件》册) - 网站遥控器的「声音」面板就是这组命令的可视化版本