更新记录

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 端请使用原生实现。

真机验证步骤

  1. 在页面中引入并调用上述 API(参考示例页 pages/index/index.uvue)。
  2. 由于插件包含原生代码,运行到 App 需使用自定义调试基座:HBuilderX → 运行 → 运行到手机或模拟器 → 制作自定义调试基座。

Android 本地打包(免云打包)

官方文档:原生SDK Android版 | 原生联调 / 自定义基座

方式一:本地制作「自定义调试基座」(推荐,日常调试)

本项目已在工程根目录提供 现成脚手架:android-base/,其 app / uniappx / m4s-speech 三个模块 与清单(DCLOUD_DEBUG、DCLOUD_UNI_APPID)均已按蒸汽模式(Vapor)配好。 直接照 android-base/README.md 放入依赖并 Build 即可。

大致流程:

  1. 准备 HBuilderX(5.x)、Android Studio、JDK 17,并下载与 HBuilderX 版本一致 的 uni-app x Android 离线SDK。
  2. 把离线 SDK 的 3 个 plugins/*.jar 放进 android-base/plugins/,25 个蒸汽模式 *.aar 放进 android-base/uniappx/libs/,debug-server-release.aar 放进 android-base/app/libs/。
  3. 用 Android Studio 打开 android-base,Build → Build APK(s)(或 ./gradlew :app:assembleRelease)。
  4. 把产物重命名为 android_debug_vapor.apk(蒸汽模式),放到项目的 unpackage/debug/ 目录。
  5. 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

本项目源码可自由使用与修改。

隐私、权限声明

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

无

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

无

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

无

暂无用户评论。