# 音程听感训练器

**Repository Path**: ludycool/interval-listening-trainer

## Basic Information

- **Project Name**: 音程听感训练器
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-20
- **Last Updated**: 2025-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 音程听感训练器

一个专为音乐学习者设计的网页应用，帮助用户通过听觉训练提升对音程的识别能力，为发展相对音感和音高记忆打基础。

## 🎵 功能特性

### 1. 虚拟钢琴键盘
- 完整的钢琴键盘显示（C2-C6，共5个八度）
- 科学音高记号法标注，按八度分组显示
- 点击任意键位可播放真实钢琴音色
- 可调节音量和基准八度
- 每个八度右侧有播放图标，可播放该八度的音阶
- 实时显示当前播放的音符名称和频率

### 2. 全音程播放
- 播放所有支持音阶的音程组合
- 提供筛选器：协和音程、不协和音程、纯音程等
- 支持随机顺序播放
- 实时进度显示和暂停/继续控制

### 3. 单音阶练习模式
- 在指定音阶内随机生成音程
- 用户选择答案并获得实时反馈
- 详细的统计信息：正确率、错误次数、连对数
- 显示正确答案和音程解析

### 4. 多音阶混合练习模式
- 支持多音阶选择和混合练习
- 三种练习模式：无限模式、计时模式(3分钟)、固定题量(20题)
- 独立的统计系统
- 当前音阶提示

## 🚀 快速开始

### 运行应用
1. 下载项目文件到本地目录
2. 用浏览器打开 `index.html` 文件
3. 确保浏览器支持Web Audio API（现代浏览器均支持）
4. 点击任意播放按钮时，浏览器可能会要求用户交互来启用音频

### 系统要求
- 现代网页浏览器（Chrome、Firefox、Safari、Edge）
- 支持Web Audio API
- 建议使用耳机或高质量扬声器以获得最佳听感体验

## 📁 文件结构
```
music/
├── index.html          # 主界面文件
├── style.css           # 样式表
├── script.js           # 核心逻辑
└── README.md           # 项目说明文档
```

## 🎼 音程知识

### 音程分类
- **纯音程**：纯一度、纯四度、纯五度、纯八度
- **大音程**：大二度、大三度、大六度、大七度  
- **小音程**：小二度、小三度、小六度、小七度
- **协和音程**：听起来稳定和谐（纯音程、大小三六度）
- **不协和音程**：听起来紧张需要解决（大小二七度、三全音）

### 支持的音阶
- **大调**：C、G、D、A、E、B、F#、Db、Ab、Eb、Bb、F
- **小调**：Am、Em、Bm、F#m、C#m、G#m、D#m、Bbm、Fm、Cm、Gm、Dm

## 💡 使用建议

### 初学者
1. 从C大调开始，选择"固定根音"模式
2. 先熟悉协和音程（纯音程、大小三度、大小六度）
3. 使用"播放前隐藏答案"进行自测

### 进阶用户
1. 尝试多个音阶的混合练习
2. 使用计时模式挑战自己
3. 重点练习不协和音程的识别

### 练习计划
- 每日15-30分钟练习
- 记录进步情况，关注正确率变化
- 循序渐进，不要急于求成

## 🔧 技术特性

- **音频引擎**：基于Tone.js实现精确音高播放
- **响应式设计**：适配桌面和移动设备
- **数据持久化**：使用localStorage保存设置和统计数据
- **现代UI**：Bootstrap 5 + 自定义样式
- **无需安装**：纯前端应用，开箱即用

## 📊 统计功能

应用会自动记录和保存：
- 正确答题数
- 错误答题数  
- 正确率百分比
- 当前连对数
- 用户设置偏好

所有数据保存在浏览器本地，确保隐私安全。

## 🎯 学习目标

通过持续使用本应用，您将能够：
- 快速识别常见音程
- 发展相对音感能力
- 提高音高记忆
- 为和声听觉训练打下基础
- 增强音乐理论理解

## 📝 版本信息

**当前版本**：MVP 1.0
**发布日期**：2025年

### 后续版本计划
- 麦克风唱名识别
- 旋律听写功能
- 绝对音高测试
- 成就系统
- 自定义训练包

---

🎵 **开始您的音程听感训练之旅吧！** 🎵