更新记录
1.2.0(2026-04-02)
- 新增 Harmony 云端音频降级实现(
cloud.endpoint + InnerAudioContext),支持 init/speak/pause/resume/stop/getVoices/getCapabilities。
- 新增微信小程序云端音频降级实现(
cloud.endpoint + InnerAudioContext),支持基础播报控制链路。
- 新增支付宝小程序云端音频降级实现(
cloud.endpoint + InnerAudioContext),支持基础播报控制链路。
- 更新平台支持矩阵:Harmony、微信小程序、支付宝小程序从“未支持”调整为“可用(云端降级)”。
- 统一三端云端回包字段解析策略(
responseField/url/audio)与错误处理语义。
- 使用说明补充:微信/支付宝/鸿蒙端进行文本播报时,需在初始化配置中提供
cloud.endpoint 或 cloud.synthesize,否则会因无可用适配器而播报失败。
1.1.0(2026-04-01)
- 新增 Android 原生
TextToSpeech 实现,支持 init/speak/pause/resume/stop/getVoices/getCapabilities。
- 新增 iOS 原生
AVSpeechSynthesizer 实现,支持 init/speak/pause/resume/stop/getVoices/getCapabilities。
- 新增 Web
SpeechSynthesis 降级实现,支持基础播报与控制能力。
- 统一 Harmony、微信小程序、支付宝小程序为明确不支持行为,返回
9011001,避免伪造成功。
- 同步更新插件平台支持矩阵与文档说明,修正实现状态与对外描述一致性。
1.0.1(2026-03-18)
- 修复 Android 真机下暂停/继续链路,优化任务超时判定与暂停期间计时策略。
- 优化插队与停止场景的任务状态收敛,减少并发测试下的误报日志。
- 增强运行时探测日志,新增
nativeChannel 与适配器可用性明细输出。
- 补齐
utssdk 目录最小结构,满足插件市场 UTS 插件目录校验要求。
- 完成 Android 真机(PBAM00 / Android 8.1.0)一键自检通过验证。
查看更多
平台兼容性
uni-app(4.84)
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
| √ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
小红书小程序 |
快应用-华为 |
快应用-联盟 |
| √ |
√ |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
uni-app x(4.84)
| Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
| √ |
√ |
√ |
√ |
√ |
√ |
lizhao-smart-tts
lizhao-smart-tts 是 UTS 语音播报插件(API + 组件)。
插件简介
当前版本已补齐基础 UTS 能力:
- Android:
TextToSpeech(init/speak/pause/resume/stop/getVoices)
- iOS:
AVSpeechSynthesizer(init/speak/pause/resume/stop/getVoices)
- Web:
SpeechSynthesis(init/speak/pause/resume/stop/getVoices)
- Harmony / 微信小程序 / 支付宝小程序:云端音频降级(
cloud.endpoint + InnerAudioContext)
队列、插队、分段回退等“编排能力”目前仍主要由 common/core.js 提供,UTS 侧是平台原生执行层。
支持平台
| 平台 |
是否支持 |
说明 |
| uni-app Android |
是 |
已接入 Android TextToSpeech,建议真机验证 |
| uni-app iOS |
是 |
已接入 iOS AVSpeechSynthesizer,建议真机验证 |
| uni-app Harmony |
是 |
云端音频降级实现,需配置 cloud.endpoint |
| uni-app Web |
是 |
已接入 Web Speech API(浏览器支持相关) |
| uni-app 微信小程序 |
是 |
云端音频降级实现,需配置 cloud.endpoint |
| uni-app 支付宝小程序 |
是 |
云端音频降级实现,需配置 cloud.endpoint |
| uni-app x Android |
是 |
与 Android 原生实现一致,建议真机验证 |
| uni-app x iOS |
是 |
与 iOS 原生实现一致,建议真机验证 |
| uni-app x Harmony |
是 |
云端音频降级实现,需配置 cloud.endpoint |
| uni-app x Web |
是 |
与 Web 实现一致 |
| uni-app x 微信小程序 |
是 |
云端音频降级实现,需配置 cloud.endpoint |
API 列表
initTTS(options)
speak(options)
pause(options)
resume(options)
stop(options)
getVoices(options)
getCapabilities(options)
on(eventName, callback)
off(eventName, callback)
参数说明
initTTS(options)
| 参数 |
类型 |
必填 |
说明 |
默认值 |
可选参数 |
| options |
InitTTSOptions |
是 |
初始化参数对象 |
无 |
lang / rate / pitch / volume / timeout / maxSegmentLength / fallbackChain / cloud / success / fail / complete |
| options.lang |
string |
否 |
默认语言 |
zh-CN |
无 |
| options.rate |
number |
否 |
语速 |
1 |
建议 0.5~2 |
| options.pitch |
number |
否 |
音调 |
1 |
建议 0~2 |
| options.volume |
number |
否 |
音量 |
1 |
建议 0~1 |
| options.timeout |
number |
否 |
单段超时毫秒 |
12000 |
无 |
| options.maxSegmentLength |
number |
否 |
最大分段长度 |
120 |
无 |
| options.fallbackChain |
Array |
否 |
回退链配置 |
['native','web','cloud'] |
native / web / cloud |
| options.cloud |
object |
否 |
云端配置透传字段 |
无 |
synthesize / endpoint / method / headers / responseField |
| options.success |
function |
否 |
成功回调 |
无 |
无 |
| options.fail |
function |
否 |
失败回调 |
无 |
无 |
| options.complete |
function |
否 |
完成回调 |
无 |
无 |
speak(options)
| 参数 |
类型 |
必填 |
说明 |
默认值 |
可选参数 |
| options |
SpeakOptions |
是 |
播报参数对象 |
无 |
text / lang / voiceName / rate / pitch / volume / timeout / priority / interrupt / maxSegmentLength / cloud / success / fail / complete |
| options.text |
string |
是 |
待播报文本 |
无 |
无 |
| options.priority |
number |
否 |
任务优先级 |
0 |
无 |
| options.interrupt |
boolean |
否 |
是否插队 |
false |
true / false |
| options.success |
function |
否 |
成功回调 |
无 |
无 |
| options.fail |
function |
否 |
失败回调 |
无 |
无 |
| options.complete |
function |
否 |
完成回调 |
无 |
无 |
pause(options) / resume(options) / stop(options)
| 参数 |
类型 |
必填 |
说明 |
默认值 |
可选参数 |
| options |
TtsActionOptions |
是 |
控制参数对象 |
无 |
success / fail / complete |
| options.success |
function |
否 |
成功回调 |
无 |
无 |
| options.fail |
function |
否 |
失败回调 |
无 |
无 |
| options.complete |
function |
否 |
完成回调 |
无 |
无 |
getVoices(options)
| 参数 |
类型 |
必填 |
说明 |
默认值 |
可选参数 |
| options |
GetVoicesOptions |
是 |
获取音色参数 |
无 |
success / fail / complete |
getCapabilities(options)
| 参数 |
类型 |
必填 |
说明 |
默认值 |
可选参数 |
| options |
GetCapabilitiesOptions |
是 |
获取能力参数 |
无 |
success / fail / complete |
返回值说明
| 字段 |
类型 |
说明 |
| initialized |
boolean |
是否初始化完成 |
| supported |
boolean |
当前平台是否已提供可用实现 |
| platform |
string |
平台标识 |
| adapter |
string |
适配器标识 |
错误码
| 错误码 |
含义 |
说明 |
| 9011001 |
platform unsupported |
当前平台不支持 |
| 9011002 |
invalid options |
参数不合法 |
| 9011003 |
runtime not initialized |
未初始化或初始化失败 |
| 9011004 |
native tts not implemented |
当前版本未实现原生 TTS |
| 9011005 |
runtime internal error |
运行时内部异常 |
权限说明
| 平台 |
是否需要权限 |
说明 |
| Android |
否 |
当前实现不需要额外权限 |
| iOS |
否 |
当前实现不需要额外权限 |
| Harmony |
否 |
云端音频降级不需要额外权限(网络权限按运行环境) |
自定义基座说明
当前版本未接入三方原生 SDK。后续如果接入系统/三方 TTS SDK,需明确标注:
- Android
config.json / AndroidManifest.xml
- iOS
Info.plist / PrivacyInfo.xcprivacy / UTS.entitlements
- 是否需要自定义基座
示例代码
uni-app / uni-app x(UTS API)
import { initTTS, speak } from '@/uni_modules/lizhao-smart-tts'
initTTS({
lang: 'zh-CN',
success(res) {
console.log('init success', res)
},
fail(err) {
console.log('init fail', err)
}
})
speak({
text: '你好',
success(res) {
console.log('speak success', res)
},
fail(err) {
console.log('speak fail', err)
}
})
注意事项
- Android / iOS / Web 已实现基础播报链路,建议先完成真机回归(初始化、播报、暂停、恢复、停止、音色枚举)。
- Harmony / 微信小程序 / 支付宝小程序采用云端降级实现,
speak 前需提供可访问的 cloud.endpoint。
- 文档与代码已按“失败可识别、不可用不伪造成功”对齐。