x-texttovoice-s 文本转语音

文本转语音播报。先初始化引擎，再调用 play / stop。

兼容性

Harmony	IOS	Android	WEB	小程序
支持	支持	支持	支持	不支持

调用

import { XTtsSpeek, xTtsImplIns } from "@/uni_modules/x-texttovoice-s"

XTtsSpeek({
  success: () => {
    xTtsImplIns.play("你好，欢迎使用")
  },
  onDone: () => {
    console.log("播放完毕")
  },
  onStop: () => {
    console.log("已停止")
  },
  fail: (res) => {
    console.error(res)
  }
})

停止：

xTtsImplIns.stop()
xTtsImplIns.isPlaying()

参数

XuiTextToVoiceOpts（初始化）

字段	说明	默认
success	初始化成功，此后可 play / stop	-
fail	初始化失败	-
complete	初始化结束	-
onStart	开始播报	-
onStop	停止播报	-
onDone	播报完成	-
onError	播报错误	-

方法

名称	需要	说明
XTtsSpeek	见上方初始化字段	初始化引擎，成功后才能 play
xTtsImplIns.play	text: string	播报文本
xTtsImplIns.stop	无	停止播报
xTtsImplIns.isPlaying	无	是否正在播放

错误码：1000 无权限，1001 初始化失败，1002 语言包缺失，1003 初始化中或播报中，1004 播放错误。

平台差异

1. 微信不支持。
2. 鸿蒙模拟器需较高 API 版本。
3. Android 缺中文语音包时返回 1002。

版本

版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。

更新日志

1.0.0（2025-10-09）

支持Android,iOS,Harmony,web/h5文本语音播报功能。