guoyu/log/备份/md/检查语音识别插件状态.md

语音识别插件状态检查

当前错误分析

根据您提供的日志：

[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. 新的错误日志