185 lines
4.9 KiB
Plaintext
185 lines
4.9 KiB
Plaintext
|
====================================
|
|||
|
|
Whisper 语音测试工具使用说明
|
|||
|
|
====================================
|
|||
|
|
|
|||
|
|
【文件说明】
|
|||
|
|
1. MP3转换测试.html - 原版（只支持百度API）
|
|||
|
|
2. MP3转换测试-Whisper版.html - 新版（支持Whisper + 百度API + 自动选择）
|
|||
|
|
|
|||
|
|
【新版功能】
|
|||
|
|
✅ 支持 Whisper 本地识别（免费、离线）
|
|||
|
|
✅ 支持百度 API 识别（在线）
|
|||
|
|
✅ 自动选择模式（优先 Whisper）
|
|||
|
|
✅ 服务状态实时检测
|
|||
|
|
✅ 完整的语音评测流程
|
|||
|
|
|
|||
|
|
====================================
|
|||
|
|
使用步骤
|
|||
|
|
====================================
|
|||
|
|
|
|||
|
|
【步骤1】配置服务地址
|
|||
|
|
---------------------------------------
|
|||
|
|
打开 MP3转换测试-Whisper版.html
|
|||
|
|
|
|||
|
|
在"服务配置"区域填写：
|
|||
|
|
1. Java后端地址: http://192.168.1.164:30091
|
|||
|
|
（你的Java应用地址）
|
|||
|
|
|
|||
|
|
2. Whisper服务地址: http://192.168.1.100:5001
|
|||
|
|
（远程Whisper服务器地址）
|
|||
|
|
|
|||
|
|
【步骤2】检测服务状态
|
|||
|
|
---------------------------------------
|
|||
|
|
点击"🔍 检测服务状态"按钮
|
|||
|
|
|
|||
|
|
查看状态指示灯：
|
|||
|
|
- 🟢 绿色：服务在线可用
|
|||
|
|
- 🔴 红色：服务离线不可用
|
|||
|
|
- 🟡 黄色：正在检测中
|
|||
|
|
|
|||
|
|
【步骤3】选择识别服务
|
|||
|
|
---------------------------------------
|
|||
|
|
三种模式可选：
|
|||
|
|
|
|||
|
|
1. 🤖 Whisper (本地)
|
|||
|
|
- 完全免费
|
|||
|
|
- 离线运行
|
|||
|
|
- 识别准确
|
|||
|
|
|
|||
|
|
2. ☁️ 百度API
|
|||
|
|
- 在线服务
|
|||
|
|
- 需要密钥
|
|||
|
|
- 稳定可靠
|
|||
|
|
|
|||
|
|
3. 🔄 自动选择（推荐）
|
|||
|
|
- 优先使用 Whisper
|
|||
|
|
- Whisper不可用时降级使用百度API
|
|||
|
|
- 智能切换
|
|||
|
|
|
|||
|
|
【步骤4】上传测试
|
|||
|
|
---------------------------------------
|
|||
|
|
1. 点击上传区域或拖拽文件
|
|||
|
|
2. 选择 MP3/M4A/AAC 格式音频
|
|||
|
|
3. 输入评测文本（与录音内容一致）
|
|||
|
|
4. 点击"开始测试转换及评测"
|
|||
|
|
5. 查看测试结果
|
|||
|
|
|
|||
|
|
====================================
|
|||
|
|
后端配置（重要）
|
|||
|
|
====================================
|
|||
|
|
|
|||
|
|
【修改 Java 配置使用远程 Whisper】
|
|||
|
|
---------------------------------------
|
|||
|
|
文件: LocalWhisperService.java
|
|||
|
|
位置: ry-study-system/src/main/java/.../service/voice/
|
|||
|
|
|
|||
|
|
修改第36行：
|
|||
|
|
private static final String WHISPER_URL = "http://localhost:5001";
|
|||
|
|
|
|||
|
|
改为远程地址：
|
|||
|
|
private static final String WHISPER_URL = "http://192.168.1.100:5001";
|
|||
|
|
|
|||
|
|
【重新编译】
|
|||
|
|
---------------------------------------
|
|||
|
|
cd Study-Vue-redis
|
|||
|
|
mvn clean package -DskipTests
|
|||
|
|
|
|||
|
|
【重启应用】
|
|||
|
|
---------------------------------------
|
|||
|
|
java -jar ry-study-admin/target/ry-study-admin.jar
|
|||
|
|
|
|||
|
|
====================================
|
|||
|
|
测试结果说明
|
|||
|
|
====================================
|
|||
|
|
|
|||
|
|
【成功结果】
|
|||
|
|
---------------------------------------
|
|||
|
|
✅ 测试完成
|
|||
|
|
📁 源文件: 显示上传的文件名
|
|||
|
|
🎤 识别文本: Whisper/百度API识别的文本
|
|||
|
|
📊 评测结果:
|
|||
|
|
- 🎯 综合得分
|
|||
|
|
- ✅ 准确度
|
|||
|
|
- 🗣️ 流利度
|
|||
|
|
- 📋 完整度
|
|||
|
|
|
|||
|
|
【失败原因】
|
|||
|
|
---------------------------------------
|
|||
|
|
1. 服务不可用
|
|||
|
|
- 检查 Whisper 服务是否启动
|
|||
|
|
- 检查 Java 应用是否运行
|
|||
|
|
- 检查网络连接
|
|||
|
|
|
|||
|
|
2. 上传失败
|
|||
|
|
- 检查文件格式（只支持 MP3/M4A/AAC）
|
|||
|
|
- 检查文件大小（建议 < 10MB）
|
|||
|
|
|
|||
|
|
3. 识别失败
|
|||
|
|
- 检查音频质量
|
|||
|
|
- 检查录音时长（建议 2-10秒）
|
|||
|
|
- 查看详细日志
|
|||
|
|
|
|||
|
|
====================================
|
|||
|
|
测试检查清单
|
|||
|
|
====================================
|
|||
|
|
|
|||
|
|
□ Whisper 服务已启动
|
|||
|
|
□ Java 应用已启动
|
|||
|
|
□ 服务地址配置正确
|
|||
|
|
□ 服务状态检测通过（绿灯）
|
|||
|
|
□ 音频文件格式正确
|
|||
|
|
□ 评测文本已填写
|
|||
|
|
□ 网络连接正常
|
|||
|
|
|
|||
|
|
====================================
|
|||
|
|
常见问题
|
|||
|
|
====================================
|
|||
|
|
|
|||
|
|
Q1: Whisper 状态显示离线怎么办？
|
|||
|
|
A1:
|
|||
|
|
1. 确认 Whisper 服务器地址正确
|
|||
|
|
2. 在服务器上运行: curl http://localhost:5001/health
|
|||
|
|
3. 检查服务器防火墙是否开放 5001 端口
|
|||
|
|
4. 确认 Whisper 服务监听地址为 0.0.0.0
|
|||
|
|
|
|||
|
|
Q2: 百度API 状态显示离线怎么办？
|
|||
|
|
A2:
|
|||
|
|
1. 确认 Java 应用已启动
|
|||
|
|
2. 访问: http://192.168.1.164:30091/study/voiceEvaluation/checkService
|
|||
|
|
3. 检查百度 API 密钥配置
|
|||
|
|
|
|||
|
|
Q3: 上传后没有反应？
|
|||
|
|
A3:
|
|||
|
|
1. 按 F12 打开浏览器开发者工具
|
|||
|
|
2. 查看 Console 标签页的错误信息
|
|||
|
|
3. 检查 Network 标签页的请求状态
|
|||
|
|
4. 确认跨域问题（CORS）
|
|||
|
|
|
|||
|
|
Q4: 识别结果不准确？
|
|||
|
|
A4:
|
|||
|
|
1. 确保录音内容与评测文本一致
|
|||
|
|
2. 使用清晰的录音环境
|
|||
|
|
3. 控制录音时长（2-10秒最佳）
|
|||
|
|
4. 尝试多次测试
|
|||
|
|
|
|||
|
|
Q5: 如何验证完整流程？
|
|||
|
|
A5:
|
|||
|
|
1. 使用手机录制一段 "你好世界" 的语音
|
|||
|
|
2. 导出为 MP3 格式
|
|||
|
|
3. 在工具中上传并设置评测文本为 "你好世界"
|
|||
|
|
4. 选择 Whisper 模式进行测试
|
|||
|
|
5. 查看识别结果是否准确
|
|||
|
|
|
|||
|
|
====================================
|
|||
|
|
技术支持
|
|||
|
|
====================================
|
|||
|
|
|
|||
|
|
如遇问题，请提供：
|
|||
|
|
1. 浏览器控制台截图（F12 → Console）
|
|||
|
|
2. 测试日志内容
|
|||
|
|
3. 服务器 Whisper 启动日志
|
|||
|
|
4. Java 应用日志（包含 Whisper 相关）
|
|||
|
|
5. 使用的音频文件（用于复现问题）
|
|||
|
|
|
|||
|
|
====================================
|