VoiceQ - 家庭影院声道检测与校准工具

VoiceQ 是一款专为家庭影院爱好者和专业人士设计的桌面应用程序，旨在帮助用户检测、分析和校准多声道音响系统。通过播放标准测试音源并进行录音分析，本工具可以提供直观的数据报告，帮助用户优化音响设置，获得最佳的沉浸式音频体验。

✨ 功能特性

• 多声道支持：支持多达12个声道的检测，包括标准的7.1.4杜比全景声（Dolby Atmos）布局。
• 多种测试模式：
  • 常规测试：播放各声道测试信号，用于基本听音辨位。
  • 粉红噪声：用于评估各声道音色一致性和频响曲线。
  • 频率扫描：通过全频段扫描信号检测系统的总谐波失真（THD）和异响。
  • 低频测试：专为低音炮（LFE）设计，用于检测低频下潜和驻波。
• 自动化分析：可选择自动录制播放的音频，并计算总谐波失真（THD），生成频谱图。
• 数据可视化：
  • 实时频谱图：直观展示单个声道的频响特性。
  • 多声道对比图：将多个声道的频响曲线或THD数据并列显示，便于比较。
• 评估报告：根据测试结果自动生成图文并茂的评估报告，提供专业的校准建议。
• 现代化UI：采用Qt和QSS构建，界面简洁、操作直观。

🛠️ 安装与环境配置

在运行本应用前，请确保您已安装 Python 3.x 环境。

1. 克隆仓库

   git clone https://github.com/iXimNet/VoiceQ.git
   cd VoiceQ

2. 安装依赖 项目所需的所有依赖库都已在 requirements.txt 文件中列出。通过以下命令安装：

   pip install -r requirements.txt

   主要依赖包括：

   • PyQt5: 用于构建图形用户界面。
   • sounddevice: 用于音频播放和录制。
   • numpy: 用于数值计算和信号处理。
   • matplotlib: 用于绘制数据图表。
   • scipy: 用于科学计算，如FFT。

🚀 如何使用

直接运行 ui/app_ui.py 文件即可启动应用程序：

python ui/app_ui.py

操作流程：

1. 选择测试类型：在应用顶部的标签页中选择一种测试模式（如常规测试、粉红噪声等）。
2. 选择声道：点击主界面中的圆形按钮选择要测试的声道。
3. 开始测试：
   • 如果勾选了“自动录音并分析”，程序将播放测试音，然后录音并生成图表和报告。
   • 如果未勾选，程序将只播放测试音，供用户手动听辨。
4. 查看结果：
   • 左下方的图表会显示频谱或THD柱状图。
   • 右侧的评估报告区域会显示详细的分析结果和建议。
5. 停止播放：在播放过程中，再次点击正在播放的声道按钮可随时停止。

🤝 贡献

欢迎对本项目进行贡献！如果您有任何建议或发现Bug，请随时提交 Issues 或 Pull Requests。

📄 许可证

本项目采用 MIT License 开源。