更新记录

1.0.0（2026-07-17）

初版

平台兼容性

uni-app(5.0)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android Android插件版本 iOS 鸿蒙
× × × × × × 8.0 1.0.0 × ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × × × × ×

s-tts

基于 Android 系统内置 TextToSpeech 引擎的文字转语音（TTS）uts 插件。当前仅实现 Android 端，iOS / Harmony 为占位实现。

需要自定义基座运行（uts 原生插件不含在标准基座中）。

API

import { speak, stop, isSpeaking, shutdown } from '@/uni_modules/s-tts'

speak(options)

参数 类型 必填 说明
text string 是 要播报的文本
language string 否 BCP-47 语言标签，如 zh-CN、en-US，默认系统语言
rate number 否 语速 0.1~2.0，默认 1.0
pitch number 否 音调 0.1~2.0，默认 1.0
flush boolean 否 true=清空队列立即播报(默认)，false=加入队列
success func 否 开始播报回调 { utteranceId, msg }
fail func 否 失败回调 { errCode, errMsg }
complete func 否 完成回调（成功/失败都触发） 
speak({
  text: '你好，世界',
  language: 'zh-CN',
  rate: 1.0,
  pitch: 1.0,
  success: (res) => console.log('开始', res),
  fail: (err) => console.log('失败', err.errCode, err.errMsg)
})

stop()

停止当前播报。

isSpeaking() : boolean

同步返回当前是否正在播报。

shutdown()

释放 TTS 引擎资源（页面卸载时可调用）。

错误码

errCode 说明
9020001 TTS 引擎初始化失败
9020002 不支持的语言
9020003 语音播报失败

验证

启动页已设为 pages/tts/tts，运行到 Android 自定义基座即可测试。

开发文档

UTS 语法 UTS API插件

隐私、权限声明

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

无

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

插件不采集任何数据

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

无

评论列表 撰写评论 向官方投诉

暂无用户评论。