更新记录
1.0.2(2026-11-19)
首次发布:完成 Android / HarmonyOS 双端实现与真机验证。
1.0.1(2026-11-19)
首次发布:完成 Android / HarmonyOS 双端实现与真机验证。
1.0.0(2026-11-19)
首次发布:完成 Android / HarmonyOS 双端实现与真机验证。
查看更多平台兼容性
uni-app x(4.25)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| × | × | √ | × | √ | × |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | × | × | √ |
uni-smart-tts 智能语音播报插件
开箱即用的语音播报插件:中英文播报、语速/音调/音量调节、播报队列、事件回调、引擎诊断。纯系统 API(Android TextToSpeech / 鸿蒙 TextToSpeechEngine),零三方 SDK 依赖。
平台支持
| 平台 | 支持 | 引擎 |
|---|---|---|
| App-Android | ✅ | TextToSpeech(系统原生) |
| App-鸿蒙 HarmonyOS | ✅ | @kit.SpeechKit TextToSpeechEngine |
| App-iOS | ⏸ 后期规划 | — |
快速开始
import { init, speak, onStateChange } from '@/uni_modules/uni-smart-tts'
// 1. 监听播报事件
onStateChange((e) => console.log('TTS 事件:', e.message))
// 2. 初始化引擎
init({
language: 'zh',
success: () => {
// 3. 播报
speak({ text: '您好,欢迎使用智能语音播报', rate: 1.0 })
},
fail: (err) => console.log('初始化失败', err.errCode)
})
API 清单
| API | 说明 |
|---|---|
init(options) |
初始化引擎(language: zh/en) |
speak(options) |
播报(text / queueMode 0清空1追加 / rate / pitch / utteranceId) |
stop(options?) |
停止播报 |
setSettings(options) |
设置语速/音调/音量 |
isSpeaking() |
是否正在播报(同步) |
onStateChange(cb) / offStateChange() |
监听/取消播报事件 |
diagnose(options) |
引擎诊断 |
release(options?) |
释放引擎 |
播报事件码
1 开始 · 2 完成 · 3 取消 · 4 引擎错误 · 5 引擎就绪
重要说明:语音数据依赖
- TTS 使用设备系统语音引擎,设备需预装中文/英文语音数据才能发声
- 部分模拟器(如 MuMu)默认无 TTS 引擎 →
diagnose().engineReady=false,属正常现象,真机通常自带 - 先用
diagnose()检查chineseAvailable/enginePackage,再播报 - Android 端可在系统设置 → 语言与输入法 → 文字转语音输出中安装语音数据
效果预览
真机(MuMu 模拟器)截图,图片托管在插件市场 CDN。

更新记录
见 changelog.md。

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 69
赞赏 0
下载 12775967
赞赏 1960
赞赏
京公网安备:11010802035340号