更新记录

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。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无额外权限(使用系统 TTS 引擎;设备需预装中文/英文语音数据)

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据,播报文本仅在本机处理

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。