云端下发文本,设备用 TTS 播报(系统引擎:Windows SAPI / macOS/iOS AVSpeech / Android TTS;另可选内置离线引擎 sherpa,首次启用时下载约 51MB 模型)。多条播报按先进先出排队依次播放。
命令样例
字段说明
字段说明
text播报文本。入队先进先出;队列上限 20 条
repeat单条连播次数(默认 1,上限 99),播够次数才轮到下一条
lang语言(zh/en),缺省跟随系统语言
volume0~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) 本地播报(仅插件本地托管页开放,不产生云端消息,见《插件》册)
  • 网站遥控器的「声音」面板就是这组命令的可视化版本