# gangqin
**Repository Path**: alan-ding/gangqin
## Basic Information
- **Project Name**: gangqin
- **Description**: Vibe coding - 简易钢琴app
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-09
- **Last Updated**: 2025-12-31
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Trae Piano
这是一个现代化的虚拟钢琴应用程序,用户可以通过鼠标点击、触摸屏幕或键盘按键来弹奏音乐。
## 版本更新
### v1.1.0
- 更新标题为"Trae Piano"
- 改进下拉菜单样式,增强选项可区分性
- 优化整体用户体验
## 功能
- 虚拟钢琴键盘(包含白键和黑键)
- 支持鼠标点击和触摸屏操作
- 支持计算机键盘按键操作(数字键1-7对应C4-B4音符)
- 支持MIDI设备连接和演奏
- 真实的音频合成和播放
- 精美的视觉效果和交互反馈
- 响应式设计,适配不同屏幕尺寸
## 技术栈
- HTML5
- CSS3 (使用了渐变、阴影、滤镜等现代CSS特性)
- JavaScript (使用了Web Audio API实现音频合成)
- Web Audio API
## 使用方法
### 方法一:直接打开
1. 在浏览器中打开 `index.html` 文件
2. 点击或触摸屏幕上的琴键来弹奏音乐
### 方法二:使用npm命令
1. 确保已安装Node.js
2. 在项目根目录运行 `npm start`
3. 在浏览器中访问 `http://localhost:8000`
## 项目结构
```
├── index.html
├── css/
│ └── style.css
├── js/
│ └── script.js
├── package.json
└── README.md
```
## 实现细节
### HTML结构
- 使用`div`元素创建钢琴键盘
- 白键和黑键分别使用不同的类名进行样式区分
### CSS样式
- 使用CSS渐变创建琴键的立体效果
- 使用阴影和模糊滤镜增强视觉体验
- 通过绝对定位精确控制黑键位置
- 添加了交互状态的样式变化
### JavaScript交互
- 使用Web Audio API实现真实的音频合成
- 支持鼠标事件(mousedown, mouseup等)
- 支持触摸事件(touchstart, touchend等)
- 支持键盘事件(keydown, keyup等)
- 实现了音频上下文的正确初始化和管理