102 lines
2.8 KiB
Markdown
102 lines
2.8 KiB
Markdown
# 语音识别插件状态检查
|
||
|
||
## 当前错误分析
|
||
|
||
根据您提供的日志：
|
||
```
|
||
[Speech] 初始化错误: Error: uts插件[xwq-speech-to-text]编译失败，无法使用
|
||
```
|
||
|
||
## 问题确认
|
||
|
||
### ✅ 已完成的修复
|
||
1. 修复了 `interface.uts` 中 `ResultData` 类型定义
|
||
- 添加了 `errorMsg?:string|null` 字段
|
||
- 这解决了类型不匹配的编译错误
|
||
|
||
### ⚠️ 需要您操作的步骤
|
||
|
||
#### 核心问题：UTS 插件未编译
|
||
UTS 插件是原生插件，必须编译后才能使用。您当前使用的是标准基座，不包含编译后的插件代码。
|
||
|
||
#### 解决步骤：
|
||
|
||
**步骤 1：制作自定义调试基座**
|
||
```
|
||
HBuilderX 菜单 → 发行 → 原生App-制作自定义调试基座
|
||
```
|
||
- 选择 Android 平台
|
||
- 等待 5-10 分钟完成打包
|
||
- 下载生成的 APK
|
||
|
||
**步骤 2：安装自定义基座**
|
||
- 将 APK 安装到您的 Android 手机
|
||
- 这个基座包含了编译好的 UTS 插件
|
||
|
||
**步骤 3：使用自定义基座运行**
|
||
```
|
||
HBuilderX 菜单 → 运行 → 运行到手机或模拟器 → 运行到Android App基座
|
||
```
|
||
- 选择刚安装的自定义基座
|
||
- 重新运行应用
|
||
|
||
**步骤 4：准备模型文件**
|
||
- 下载 Vosk 中文模型：https://alphacephei.com/vosk/models
|
||
- 推荐：`vosk-model-small-cn-0.22.zip`
|
||
- 放到项目的 `/static/` 目录下
|
||
|
||
## 验证清单
|
||
|
||
- [ ] 已修复 interface.uts 类型定义（已完成）
|
||
- [ ] 已制作自定义调试基座
|
||
- [ ] 已安装自定义基座到手机
|
||
- [ ] 已下载并放置 Vosk 模型文件
|
||
- [ ] 使用自定义基座运行应用
|
||
- [ ] 测试语音识别功能
|
||
|
||
## 预期结果
|
||
|
||
完成上述步骤后，您应该看到：
|
||
```
|
||
[Speech] ========== 开始初始化语音模型 ==========
|
||
[Speech] 已保存的模型路径: /storage/emulated/0/...
|
||
[Speech] 模型加载成功
|
||
```
|
||
|
||
而不是：
|
||
```
|
||
[Speech] 初始化错误: Error: uts插件[xwq-speech-to-text]编译失败
|
||
```
|
||
|
||
## 为什么需要自定义基座？
|
||
|
||
| 基座类型 | UTS 插件支持 | 适用场景 |
|
||
|---------|------------|---------|
|
||
| 标准基座 | ❌ 不支持 | 纯 JS/Vue 开发 |
|
||
| 自定义基座 | ✅ 支持 | 使用原生插件开发 |
|
||
| 云打包 | ✅ 支持 | 正式发布 |
|
||
|
||
UTS 插件需要编译成 Kotlin/Java 原生代码，标准基座不包含这些代码，所以会报"编译失败"的错误。
|
||
|
||
## 其他注意事项
|
||
|
||
1. **首次解压模型需要时间**
|
||
- 约 30 秒，请耐心等待
|
||
- 解压后会缓存，下次启动很快
|
||
|
||
2. **权限请求**
|
||
- 首次使用会请求麦克风权限
|
||
- 请允许权限，否则无法录音
|
||
|
||
3. **测试建议**
|
||
- 在安静环境测试
|
||
- 清晰朗读，每句话后稍作停顿
|
||
- 可以使用"手动输入"功能测试评分逻辑
|
||
|
||
## 需要帮助？
|
||
|
||
如果完成上述步骤后仍有问题，请提供：
|
||
1. HBuilderX 版本号
|
||
2. 自定义基座打包日志
|
||
3. 新的错误日志
|