更新记录

1.2.0(2026-04-02)

  • 新增 Harmony 云端音频降级实现(cloud.endpoint + InnerAudioContext),支持 init/speak/pause/resume/stop/getVoices/getCapabilities
  • 新增微信小程序云端音频降级实现(cloud.endpoint + InnerAudioContext),支持基础播报控制链路。
  • 新增支付宝小程序云端音频降级实现(cloud.endpoint + InnerAudioContext),支持基础播报控制链路。
  • 更新平台支持矩阵:Harmony、微信小程序、支付宝小程序从“未支持”调整为“可用(云端降级)”。
  • 统一三端云端回包字段解析策略(responseField/url/audio)与错误处理语义。
  • 使用说明补充:微信/支付宝/鸿蒙端进行文本播报时,需在初始化配置中提供 cloud.endpointcloud.synthesize,否则会因无可用适配器而播报失败。

1.1.0(2026-04-01)

  • 新增 Android 原生 TextToSpeech 实现,支持 init/speak/pause/resume/stop/getVoices/getCapabilities
  • 新增 iOS 原生 AVSpeechSynthesizer 实现,支持 init/speak/pause/resume/stop/getVoices/getCapabilities
  • 新增 Web SpeechSynthesis 降级实现,支持基础播报与控制能力。
  • 统一 Harmony、微信小程序、支付宝小程序为明确不支持行为,返回 9011001,避免伪造成功。
  • 同步更新插件平台支持矩阵与文档说明,修正实现状态与对外描述一致性。

1.0.1(2026-03-18)

  • 修复 Android 真机下暂停/继续链路,优化任务超时判定与暂停期间计时策略。
  • 优化插队与停止场景的任务状态收敛,减少并发测试下的误报日志。
  • 增强运行时探测日志,新增 nativeChannel 与适配器可用性明细输出。
  • 补齐 utssdk 目录最小结构,满足插件市场 UTS 插件目录校验要求。
  • 完成 Android 真机(PBAM00 / Android 8.1.0)一键自检通过验证。
查看更多

平台兼容性

uni-app(4.84)

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

uni-app x(4.84)

Chrome Safari Android iOS 鸿蒙 微信小程序

lizhao-smart-tts

lizhao-smart-tts 是 UTS 语音播报插件(API + 组件)。

插件简介

当前版本已补齐基础 UTS 能力:

  • Android:TextToSpeech(init/speak/pause/resume/stop/getVoices)
  • iOS:AVSpeechSynthesizer(init/speak/pause/resume/stop/getVoices)
  • Web:SpeechSynthesis(init/speak/pause/resume/stop/getVoices)
  • Harmony / 微信小程序 / 支付宝小程序:云端音频降级(cloud.endpoint + InnerAudioContext

队列、插队、分段回退等“编排能力”目前仍主要由 common/core.js 提供,UTS 侧是平台原生执行层。

支持平台

平台 是否支持 说明
uni-app Android 已接入 Android TextToSpeech,建议真机验证
uni-app iOS 已接入 iOS AVSpeechSynthesizer,建议真机验证
uni-app Harmony 云端音频降级实现,需配置 cloud.endpoint
uni-app Web 已接入 Web Speech API(浏览器支持相关)
uni-app 微信小程序 云端音频降级实现,需配置 cloud.endpoint
uni-app 支付宝小程序 云端音频降级实现,需配置 cloud.endpoint
uni-app x Android 与 Android 原生实现一致,建议真机验证
uni-app x iOS 与 iOS 原生实现一致,建议真机验证
uni-app x Harmony 云端音频降级实现,需配置 cloud.endpoint
uni-app x Web 与 Web 实现一致
uni-app x 微信小程序 云端音频降级实现,需配置 cloud.endpoint

API 列表

  • initTTS(options)
  • speak(options)
  • pause(options)
  • resume(options)
  • stop(options)
  • getVoices(options)
  • getCapabilities(options)
  • on(eventName, callback)
  • off(eventName, callback)

参数说明

initTTS(options)

参数 类型 必填 说明 默认值 可选参数
options InitTTSOptions 初始化参数对象 lang / rate / pitch / volume / timeout / maxSegmentLength / fallbackChain / cloud / success / fail / complete
options.lang string 默认语言 zh-CN
options.rate number 语速 1 建议 0.5~2
options.pitch number 音调 1 建议 0~2
options.volume number 音量 1 建议 0~1
options.timeout number 单段超时毫秒 12000
options.maxSegmentLength number 最大分段长度 120
options.fallbackChain Array 回退链配置 ['native','web','cloud'] native / web / cloud
options.cloud object 云端配置透传字段 synthesize / endpoint / method / headers / responseField
options.success function 成功回调
options.fail function 失败回调
options.complete function 完成回调

speak(options)

参数 类型 必填 说明 默认值 可选参数
options SpeakOptions 播报参数对象 text / lang / voiceName / rate / pitch / volume / timeout / priority / interrupt / maxSegmentLength / cloud / success / fail / complete
options.text string 待播报文本
options.priority number 任务优先级 0
options.interrupt boolean 是否插队 false true / false
options.success function 成功回调
options.fail function 失败回调
options.complete function 完成回调

pause(options) / resume(options) / stop(options)

参数 类型 必填 说明 默认值 可选参数
options TtsActionOptions 控制参数对象 success / fail / complete
options.success function 成功回调
options.fail function 失败回调
options.complete function 完成回调

getVoices(options)

参数 类型 必填 说明 默认值 可选参数
options GetVoicesOptions 获取音色参数 success / fail / complete

getCapabilities(options)

参数 类型 必填 说明 默认值 可选参数
options GetCapabilitiesOptions 获取能力参数 success / fail / complete

返回值说明

字段 类型 说明
initialized boolean 是否初始化完成
supported boolean 当前平台是否已提供可用实现
platform string 平台标识
adapter string 适配器标识

错误码

错误码 含义 说明
9011001 platform unsupported 当前平台不支持
9011002 invalid options 参数不合法
9011003 runtime not initialized 未初始化或初始化失败
9011004 native tts not implemented 当前版本未实现原生 TTS
9011005 runtime internal error 运行时内部异常

权限说明

平台 是否需要权限 说明
Android 当前实现不需要额外权限
iOS 当前实现不需要额外权限
Harmony 云端音频降级不需要额外权限(网络权限按运行环境)

自定义基座说明

当前版本未接入三方原生 SDK。后续如果接入系统/三方 TTS SDK,需明确标注:

  • Android config.json / AndroidManifest.xml
  • iOS Info.plist / PrivacyInfo.xcprivacy / UTS.entitlements
  • 是否需要自定义基座

示例代码

uni-app / uni-app x(UTS API)

import { initTTS, speak } from '@/uni_modules/lizhao-smart-tts'

initTTS({
  lang: 'zh-CN',
  success(res) {
    console.log('init success', res)
  },
  fail(err) {
    console.log('init fail', err)
  }
})

speak({
  text: '你好',
  success(res) {
    console.log('speak success', res)
  },
  fail(err) {
    console.log('speak fail', err)
  }
})

注意事项

  • Android / iOS / Web 已实现基础播报链路,建议先完成真机回归(初始化、播报、暂停、恢复、停止、音色枚举)。
  • Harmony / 微信小程序 / 支付宝小程序采用云端降级实现,speak 前需提供可访问的 cloud.endpoint
  • 文档与代码已按“失败可识别、不可用不伪造成功”对齐。

隐私、权限声明

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

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

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

暂无用户评论。