59 lines
1.3 KiB
Markdown
59 lines
1.3 KiB
Markdown
|
# QZMusic Web
|
|||
|
|
|
|||
|
|
QZMusic 网页版，基于 Vue 3 + TypeScript + Vite 构建的音乐播放器。
|
|||
|
|
|
|||
|
|
## 功能特性
|
|||
|
|
|
|||
|
|
- 🎵 音乐播放控制（播放/暂停、上一首、下一首）
|
|||
|
|
- 📜 播放列表管理
|
|||
|
|
- 🎨 深色/浅色主题切换
|
|||
|
|
- 🎚️ 音量控制
|
|||
|
|
- 📊 音频可视化（基于 Web Audio API）
|
|||
|
|
- 🔍 搜索功能
|
|||
|
|
|
|||
|
|
## 开发
|
|||
|
|
|
|||
|
|
### 安装依赖
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm install
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 启动开发服务器
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run dev
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 构建生产版本
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
├── src/
|
|||
|
|
│ ├── assets/ # 静态资源
|
|||
|
|
│ ├── components/ # 组件
|
|||
|
|
│ ├── layout/ # 布局组件
|
|||
|
|
│ ├── stores/ # Pinia 状态管理
|
|||
|
|
│ ├── styles/ # 样式文件
|
|||
|
|
│ ├── types/ # TypeScript 类型定义
|
|||
|
|
│ ├── utils/ # 工具函数
|
|||
|
|
│ ├── views/ # 页面组件
|
|||
|
|
│ ├── App.vue # 根组件
|
|||
|
|
│ └── main.ts # 入口文件
|
|||
|
|
├── public/ # 公开资源
|
|||
|
|
├── index.html # HTML 模板
|
|||
|
|
├── vite.config.ts # Vite 配置
|
|||
|
|
└── tsconfig.json # TypeScript 配置
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
- 网页版移除了原 Electron 项目的本地文件系统访问和原生插件功能
|
|||
|
|
- 音乐播放使用 HTML5 Audio API
|
|||
|
|
- 音频可视化使用 Web Audio API
|