78 lines
2.5 KiB
Markdown
78 lines
2.5 KiB
Markdown
|
# 语音识别问题解决方案
|
|||
|
|
|
|||
|
|
## 问题描述
|
|||
|
|
```
|
|||
|
|
找不到名称"vosk"
|
|||
|
|
uts插件[xwq-speech-to-text]编译失败，无法使用
|
|||
|
|
uni_module [xwq-speech-to-text] (Android) 存在三方依赖或资源引用
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 根本原因
|
|||
|
|
1. UTS 插件需要编译成原生代码才能运行
|
|||
|
|
2. Vosk 是第三方依赖库，本地编译环境找不到
|
|||
|
|
3. **必须使用云端打包**，让云端服务器处理依赖
|
|||
|
|
|
|||
|
|
## 解决方案（3步）
|
|||
|
|
|
|||
|
|
### 1️⃣ 修复代码（已完成）
|
|||
|
|
✅ 已修复 `interface.uts` 类型定义问题
|
|||
|
|
- 文件：`fronted_uniapp/uni_modules/xwq-speech-to-text/utssdk/interface.uts`
|
|||
|
|
- 添加了 `errorMsg` 字段到 `ResultData` 类型
|
|||
|
|
|
|||
|
|
### 2️⃣ 云端制作自定义基座（需要您操作）⭐ 关键步骤
|
|||
|
|
在 HBuilderX 中：
|
|||
|
|
```
|
|||
|
|
发行 → 原生App-云打包
|
|||
|
|
```
|
|||
|
|
- ✅ **勾选 "打包为自定义调试基座"**（重要！）
|
|||
|
|
- 选择 Android 平台
|
|||
|
|
- 证书可用 DCloud 公共证书
|
|||
|
|
- 等待 5-10 分钟
|
|||
|
|
- 下载并安装生成的 APK 到手机
|
|||
|
|
|
|||
|
|
然后配置运行方式：
|
|||
|
|
```
|
|||
|
|
运行 → 运行到手机或模拟器 → 运行配置
|
|||
|
|
→ 选择 "自定义调试基座"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3️⃣ 准备模型文件
|
|||
|
|
- 下载：https://alphacephei.com/vosk/models
|
|||
|
|
- 推荐：`vosk-model-small-cn-0.22.zip`
|
|||
|
|
- 放到：`fronted_uniapp/static/` 目录
|
|||
|
|
|
|||
|
|
## 详细文档
|
|||
|
|
- 🎯 [【操作指南】云端打包自定义基座](fronted_uniapp/【操作指南】云端打包自定义基座.md) ⭐ **推荐阅读**
|
|||
|
|
- 📖 [语音识别插件编译说明](fronted_uniapp/语音识别插件编译说明.md)
|
|||
|
|
- 🔍 [检查语音识别插件状态](fronted_uniapp/检查语音识别插件状态.md)
|
|||
|
|
- ⚙️ [配置本地Android编译环境](fronted_uniapp/配置本地Android编译环境.md)
|
|||
|
|
|
|||
|
|
## 快速检查清单
|
|||
|
|
- [x] 代码修复完成
|
|||
|
|
- [ ] **云端打包**自定义调试基座（勾选"打包为自定义调试基座"）
|
|||
|
|
- [ ] 安装基座到手机
|
|||
|
|
- [ ] 配置 HBuilderX 使用"自定义调试基座"运行
|
|||
|
|
- [ ] 下载模型文件到 static 目录
|
|||
|
|
- [ ] 测试功能
|
|||
|
|
|
|||
|
|
## 关键要点
|
|||
|
|
|
|||
|
|
### ❌ 错误做法
|
|||
|
|
- 使用标准基座运行
|
|||
|
|
- 尝试本地编译（会报"找不到名称vosk"）
|
|||
|
|
- 使用 `发行 → 原生App-制作自定义调试基座`（本地编译）
|
|||
|
|
|
|||
|
|
### ✅ 正确做法
|
|||
|
|
- 使用 `发行 → 原生App-云打包` + 勾选"打包为自定义调试基座"
|
|||
|
|
- 让云端服务器处理 Vosk 依赖
|
|||
|
|
- 配置 HBuilderX 使用自定义基座运行
|
|||
|
|
|
|||
|
|
## 为什么必须云端打包？
|
|||
|
|
```
|
|||
|
|
UTS 插件 + 第三方依赖（Vosk）
|
|||
|
|
↓
|
|||
|
|
本地编译 ❌ 找不到 org.vosk 包
|
|||
|
|
↓
|
|||
|
|
云端编译 ✅ 自动下载和编译所有依赖
|
|||
|
|
```
|