# 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 这是一个现代化的虚拟钢琴应用程序,用户可以通过鼠标点击、触摸屏幕或键盘按键来弹奏音乐。

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等) - 实现了音频上下文的正确初始化和管理