更新记录

1.0.0(2026-11-05)

  • 首发:语音识别/合成(ASR 双模 + TTS + 字幕/朗读组件),引擎可插拔,付费闸门,纯本地合规。

平台兼容性

uni-app(4.0)

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

zl-voice-kit 语音识别合成 Pro

uni-app 语音识别/合成组件:ASR(在线长句 + 离线命令词)+ TTS(多音色/语速)+ 实时字幕/朗读,引擎可插拔。 版本:v1.0.0 | 类型:UTS 插件(component-uts)| 授权:普通授权版 + 源码授权版

功能特性

  • ASR 双模:在线长句(自有云端按量计费)+ 离线命令词(弱网/无网可用,自定义词表);VAD 端点检测。
  • TTS:多音色/语速/音调;SSML;预生成缓存。
  • 字幕组件:实时字幕条(逐句高亮);朗读组件(播报 + 高亮同步)。
  • 引擎可插拔:local(离线)/ own-cloud(自有云端)/ third-party(三方适配器)统一回调。
  • 交互:按住说话、松开发送、波形反馈、离线/在线徽标、断网自动降级。
  • 付费闸门:在线长句/多音色 TTS 为 Pro(enablePro/licenseKey/licenseApi 三级校验)。

快速上手

<zl-voice :enable-pro="true" :commands="['打开','关闭','暂停','返回']" @result="onResult" @buy="onBuy" />

或调用编排 API(utils/voice.ts):

import { createRecognizer, matchCommand, chunkSubtitle, buildSubtitleStream, streamSubtitles, synthesize } from '@/uni_modules/zl-voice-kit/utils/voice'
const r = await createRecognizer({ engine: 'local', commandDict: ['打开','关闭'] })('好的,打开首页')

API

函数 说明
matchCommand(text, dict) 离线命令词匹配
chunkSubtitle(text, maxLen) 字幕分句
buildSubtitleStream(text, wpm) 字幕流(含时长)
streamSubtitles(text, onChunk, wpm) 逐句流式回调
createRecognizer(options) 引擎适配器(local/own-cloud/third-party)
synthesize(text, opts) TTS(引擎接入后生效)

引擎接入(真机)

  • 离线命令词:纯 JS 匹配,无需引擎(默认可用)。
  • 在线识别:自有服务端(server/voice-reference.js,HMAC 验签 + 转写即弃)或三方引擎适配器。
  • 录音:utssdk(Android MediaRecorder / iOS AVAudioRecorder)接入后 getCapability().ready=true。

合规声明(重要)

  • 默认纯本地(离线命令词):不采集、不存储、不上传任何语音。
  • 在线模式:用户主动按住说话时上传语音片段到接入方自有服务端识别(可关闭);识别后即弃,不入库。
  • 麦克风权限用户主动触发时申请(RECORD_AUDIO / iOS 麦克风)。
  • 不采集用户画像数据;引擎按开源/服务商许可合规。

性能目标(真机验收)

在线识别首字 ≤400ms|离线命令词响应 ≤200ms|TTS 首音 ≤150ms|内存 ≤80MB|连续识别 10min 功耗 ≤2%。

变更记录

见 CHANGELOG.md。

隐私、权限声明

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

Android:RECORD_AUDIO(用户主动按住说话时申请)。iOS:麦克风权限(用户主动触发时系统弹窗授权)。

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

本插件语音识别支持两种模式:①纯本地模式(离线命令词,不采集上传任何语音);②在线模式(用户主动按住说话时上传语音片段到接入方自有服务端识别,可由接入方关闭)。默认纯本地,不采集、不存储用户语音,不采集用户画像数据。

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

无

暂无用户评论。