移动端音量偶尔很小问题 - 修复说明

问题分析

根本原因

AudioContext状态失效：移动端浏览器在深度对话中，AudioContext可能进入suspended状态（页面切换、锁屏、后台运行）
音量增益未持续验证：4.5倍增益只在初始化时设置，未在每次播放前验证
缺少自动恢复机制：无法自动检测和恢复音频环境异常

影响场景

长时间对话后
页面切换到后台再返回
手机锁屏后解锁
系统音量调整后

解决方案

核心修改

1. 增强AudioContext状态管理

文件: frontend/src/utils/audioPlayerStreaming.ts

// 新增方法：确保AudioContext处于运行状态
private async ensureAudioContextReady(): Promise<boolean>

功能:

检查AudioContext状态（suspended/running/closed）
自动恢复被挂起的AudioContext
验证并恢复4.5倍音量增益
详细日志记录，便于排查

2. 播放前强制检查

在以下3个关键点检查AudioContext：

开始流式播放前 (startStreamingPlayback)
- 异步检查，确保环境就绪
AI回复完成触发播放时 (play)
- 双重保险，防止遗漏
每个音频片段播放前 (playIncrementalAudio)
- 同步快速检查
- 即时恢复音量增益

3. 页面可见性监听

文件: frontend/src/components/MainPage.tsx

// 监听页面进入前台/后台
document.addEventListener('visibilitychange', handleVisibilityChange)

效果:

页面重新激活时自动恢复AudioContext
防止后台挂起导致的音量问题

4. 每次录音前激活

修改: handlePressRecord

每次按下录音按钮都调用prepareForPlayback()
利用用户交互事件激活AudioContext
解决Safari自动播放限制

技术细节

AudioContext状态机

running    ✅ 正常播放
suspended  ⚠️  需要resume() - 导致无声或音量小
closed     ❌ 需要重新创建

音量增益验证

目标增益: 4.5倍
检查阈值: 4.0倍
恢复逻辑: currentGain < 4.0 → 恢复至4.5

测试步骤

测试环境

iPhone/iPad (Safari浏览器)
Android (Chrome浏览器)
建议使用HTTPS访问（移动端要求）

测试场景

场景1：连续对话测试

打开应用，进行第1轮对话 ✅ 音量正常
连续进行5-10轮对话 ✅ 音量保持稳定
观察控制台日志，确认每次都检查音量

预期结果: 所有轮次音量一致

场景2：页面切换测试

进行第1轮对话 ✅ 音量正常
切换到其他App（微信、浏览器其他标签）
等待10-30秒
切换回应用
立即进行第2轮对话

预期结果:

控制台显示"页面重新激活"日志
音量保持正常

场景3：锁屏测试

进行第1轮对话 ✅
锁屏手机30秒
解锁
立即进行第2轮对话

预期结果: 音量恢复正常

场景4：长时间待机测试

打开应用，不操作
等待5分钟
进行对话

预期结果: 音量正常

关键日志监控

正常日志示例：

🎯 用户交互：检查并激活AudioContext
🔍 AudioContext状态检查: running
✅ 音量增益正常: 4.5倍
🎵 播放增量音频: 2.35秒 (跳过前0.00秒)

异常恢复日志示例：

⚠️ AudioContext被挂起，尝试恢复...
✅ AudioContext已恢复: running
⚠️ 播放前检测到音量过低 (1)，恢复至4.5

验证清单

连续10轮对话，音量稳定
页面切换后音量正常
锁屏解锁后音量正常
控制台显示AudioContext检查日志
控制台显示音量增益验证日志
无"音量过低"警告（或出现后立即恢复）

注意事项

测试时保持音量固定：避免手动调整系统音量干扰测试
观察控制台：所有关键操作都有emoji日志
对比修复前后：建议先用旧版本复现问题，再测试新版本
真机测试必须：桌面浏览器无法完全模拟移动端AudioContext行为

如遇问题

音量仍然过小

检查控制台：

AudioContext状态检查 是否显示running
音量增益 是否为4.5
是否有红色错误日志

完全无声

检查手机静音开关
检查浏览器权限（Safari的声音权限）
控制台是否显示AudioContext错误

后续优化建议

如问题仍偶发，可考虑：

增加音量波形分析（检测实际输出音量）
动态调整增益倍数（5.0-8.0倍）
使用AnalyserNode监控实时音量
添加用户手动音量调节控制

移动端音量修复说明.md 4.6 KB Histórico Raw