更新记录
1.2.0(2026-11-20)
纯文字转语音
平台兼容性
uni-app(5.31)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ | × |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| × | × | × | × | × | × | × | × | × | × | × | × |
uni-app x(5.05)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | √ | √ | √ | × | × |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | × | √ | √ |
m4s-speech 文字转语音插件
一个把「文字转语音(TTS)」封装起来的 UTS API 插件,支持 uni-app x 的 App-Android / App-iOS / Web 平台。
- 文字转语音:Android 用系统
TextToSpeech,iOS 用AVSpeechSynthesizer,Web 用speechSynthesis - 无需任何三方 SDK,零额外体积;小程序等未适配平台会统一回调「当前平台不支持」
目录结构
uni_modules/m4s-speech/
├── package.json
├── readme.md
├── changelog.md
└── utssdk/
├── interface.uts # 对外类型声明
├── unierror.uts # 错误码
├── index.uts # 跨平台兜底实现(未适配平台回落于此)
├── app-android/
│ ├── index.uts # Android 原生实现
│ └── AndroidManifest.xml # 插件原生清单(当前无需任何权限)
├── app-ios/
│ ├── index.uts # iOS 原生实现
│ └── Info.plist # 插件权限用途说明(当前无需任何权限)
└── web/
└── index.uts # Web(H5) 实现
快速开始
import {
speak, stopSpeak, isTTSSupported, isSpeaking, releaseTTS
} from '@/uni_modules/m4s-speech'
文字转语音
if (isTTSSupported()) {
speak({ text: '你好,世界', rate: 1.0, pitch: 1.0, lang: 'zh-CN' }, (done, msg) => {
console.log(done ? '朗读完成' : ('失败:' + msg))
})
}
stopSpeak() // 停止朗读
releaseTTS() // 页面卸载时释放引擎
| 参数 | 类型 | 说明 |
|---|---|---|
text |
string | 要朗读的文本(必填) |
rate |
number? | 语速 0.5~2.0,默认 1.0 |
pitch |
number? | 音调 0.5~2.0,默认 1.0 |
lang |
string? | 语言,如 zh-CN,省略时跟随系统 |
错误码(unierror.uts)
| 常量 | 值 | 含义 |
|---|---|---|
ERR_PARAM |
9103001 | 参数不合法 |
ERR_TTS_FAILED |
9103002 | 语音合成失败 |
ERR_UNSUPPORTED |
9103006 | 当前平台不支持 |
各平台说明
Android
- 使用系统
TextToSpeech引擎,无需任何权限。 - 发音依赖设备已安装的 TTS 引擎(系统自带或用户安装的第三方引擎)。
iOS
- 使用系统
AVSpeechSynthesizer,无需任何权限。
Web
- 文字转语音依赖
speechSynthesis,主流浏览器均支持。 - Web 实现主要用于 H5 调试,App 端请使用原生实现。
真机验证步骤
- 在页面中引入并调用上述 API(参考示例页
pages/index/index.uvue)。 - 由于插件包含原生代码,运行到 App 需使用自定义调试基座:HBuilderX → 运行 → 运行到手机或模拟器 → 制作自定义调试基座。
Android 本地打包(免云打包)
官方文档:原生SDK Android版 | 原生联调 / 自定义基座
方式一:本地制作「自定义调试基座」(推荐,日常调试)
本项目已在工程根目录提供 现成脚手架:
android-base/,其app/uniappx/m4s-speech三个模块 与清单(DCLOUD_DEBUG、DCLOUD_UNI_APPID)均已按蒸汽模式(Vapor)配好。 直接照android-base/README.md放入依赖并 Build 即可。
大致流程:
- 准备 HBuilderX(5.x)、Android Studio、JDK 17,并下载与 HBuilderX 版本一致 的 uni-app x Android 离线SDK。
- 把离线 SDK 的 3 个
plugins/*.jar放进android-base/plugins/,25 个蒸汽模式*.aar放进android-base/uniappx/libs/,debug-server-release.aar放进android-base/app/libs/。 - 用 Android Studio 打开
android-base,Build → Build APK(s)(或./gradlew :app:assembleRelease)。 - 把产物重命名为
android_debug_vapor.apk(蒸汽模式),放到项目的unpackage/debug/目录。 - HBuilderX → 运行 → 运行到 Android App 基座 → 选择该自定义基座。之后改 uvue/uts 都是热更,无需再打包。
方式二:本地离线打包发行 APK
HBuilderX → 发行 → 原生App-本地打包 → 生成本地打包App资源,得到以 AppID 命名的 __UNI__XXXX 目录;放入 android-base/uniappx/src/main/assets/apps/,配置包名 / 证书 / 离线 AppKey 后 Build 出 APK。详见 android-base/README.md 第八节。
License
本项目源码可自由使用与修改。

收藏人数:
购买普通授权版(
试用
使用 HBuilder 导入示例项目
赞赏(0)
下载 0
赞赏 0
下载 12778816
赞赏 1960
赞赏
京公网安备:11010802035340号