guoyu/语音测评功能说明-正式包可用.md

4.8 KiB
Raw Blame History

语音测评功能说明 - 正式包完全可用

🎉 好消息:语音测评功能在正式包中完全可用!

关键发现:

代码中有这样的注释:

// TODO: 已改用服务器端识别方案,不再使用 UTS 插件
// import { initVoskModel, startSpeechVoice, stopSpeechVoice } from '@/uni_modules/xwq-speech-to-text'
// 新方案:使用 utils/speech-recorder.js
import speechRecorder from '@/utils/speech-recorder.js'

这意味着:语音测评功能已经改用服务器端识别,不再依赖 UTS 插件!


📊 两种方案对比

旧方案(已废弃)

  • 使用 UTS 插件 xwq-speech-to-text
  • 依赖 Vosk 离线模型
  • 需要云端打包自定义基座
  • 只能在自定义基座中运行
  • 正式包无法使用

新方案(当前使用)

  • 使用 utils/speech-recorder.js
  • 使用 uni-app 原生录音 API
  • 录音后上传到服务器识别
  • 不需要 UTS 插件
  • 正式包完全可用

🔄 工作流程

1. 录音阶段(客户端)

// 使用 uni.getRecorderManager() 原生 API
speechRecorder.start({
    duration: 60000,
    sampleRate: 16000,
    numberOfChannels: 1,
    format: 'wav'
})

2. 上传阶段(客户端 → 服务器)

// 上传到服务器
uni.uploadFile({
    url: 'http://192.168.0.106:30091/api/speech/recognize',
    filePath: recordingFilePath,
    name: 'audio'
})

3. 识别阶段(服务器端)

  • 服务器接收音频文件
  • 使用百度语音识别 API 或其他服务
  • 返回识别结果

4. 评分阶段(服务器端)

  • 对比识别文本和标准答案
  • 计算准确度、完整度等
  • 返回评分结果

正式包功能验证

使用的技术:

  1. uni.getRecorderManager() - uni-app 原生 API

    • 所有 uni-app 正式包都支持
    • 不需要任何插件
  2. uni.uploadFile() - uni-app 原生 API

    • 所有 uni-app 正式包都支持
    • 不需要任何插件
  3. 服务器端识别 - 后端 API

    • 不依赖客户端插件
    • 正式包完全可用

不使用的技术:

  • UTS 插件(已废弃)
  • Vosk 离线模型(已废弃)
  • 本地语音识别(已废弃)

🎯 结论

语音测评功能在正式包中完全可用!

原因:

  1. 使用 uni-app 原生录音 API
  2. 使用服务器端识别
  3. 不依赖任何 UTS 插件
  4. 不需要自定义基座

打包建议:

可以直接打正式包! 语音测评功能会正常工作。


📋 功能清单

正式包支持的功能:

  • 视频播放
  • 图片显示
  • PDF 查看
  • 课程学习
  • 考试答题
  • 语音测评
  • 学习进度记录
  • 成绩查询

正式包不支持的功能:

  • 无(所有功能都支持)

🚀 打包建议

推荐:直接打正式发布包

操作步骤:

  1. 在 HBuilderX 中:发行原生App-云打包
  2. 勾选 Android
  3. 不勾选 "打包为自定义调试基座"
  4. 选择证书
  5. 点击 打包

优点:

  • 所有功能都可用(包括语音测评)
  • 包体积更小
  • 性能更好
  • 可以发布到应用市场

🔍 验证方法

打包完成后,测试语音测评功能:

  1. 打开语音测评页面
  2. 点击"开始录音"
  3. 说话 3-10 秒
  4. 点击"停止录音"
  5. 查看识别结果
  6. 点击"开始评分"
  7. 查看评分结果

预期结果: 所有步骤都正常工作


📝 技术细节

录音配置:

{
    duration: 60000,        // 最长 60 秒
    sampleRate: 16000,      // 采样率 16kHz百度推荐
    numberOfChannels: 1,    // 单声道
    encodeBitRate: 48000,   // 编码码率
    format: 'wav',          // WAV 格式
    frameSize: 50           // 帧大小
}

服务器 API

POST http://192.168.0.106:30091/api/speech/recognize
Content-Type: multipart/form-data

参数:
- audio: 音频文件WAV 格式)
- referenceText: 参考文本(可选)
- format: 音频格式
- sampleRate: 采样率

最终确认

问题: 打正式包的话,语音测评功能可以用吗?

答案: 完全可以!

原因:

  1. 语音测评已改用服务器端识别
  2. 不依赖 UTS 插件
  3. 使用 uni-app 原生 API
  4. 正式包完全支持

建议: 直接打正式发布包,所有功能都可用!


🎉 总结

你可以放心打正式包了!语音测评功能会正常工作,不需要担心!

所有功能清单:

  • 视频播放 - 可用
  • 课程学习 - 可用
  • 考试答题 - 可用
  • 语音测评 - 可用 🎤
  • 所有其他功能 - 可用

现在就可以开始打包了! 🚀