# metronome-app

**Repository Path**: zyf0744_admin/metronome-app

## Basic Information

- **Project Name**: metronome-app
- **Description**: 吉他节拍器+调音器 app
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-03-27
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 节拍器应用 (Metronome App)

基于UniApp开发的专业节拍器应用，支持多种功能与自定义设置。

## 功能特点

- 支持30-240 BPM速度范围
- 多种拍号选择 (4/4, 3/4, 2/4, 6/8, 5/4)
- 点击计算速度功能
- 多种声音类型 (点击声、木鱼声、鼓声、电子声)
- 振动反馈（强弱拍区分）
- 背景播放
- 主题切换
- 设置保存
- 设备测试工具
- 支持Base64编码音频作为备选方案

## 开发环境

- Node.js
- HBuilderX
- Vue.js
- UniApp

## 安装与运行

1. 克隆项目到本地
   ```
   git clone [项目地址]
   ```

2. 安装依赖
   ```
   npm install
   ```[]()

3. 下载音频文件
   ```
   npm run download-sounds
   ```

4. 使用HBuilderX打开项目，然后运行到浏览器或模拟器

## 项目结构

```
metronome-app/
├── pages/                 # 页面文件
│   ├── index/             # 主节拍器页面
│   ├── settings/          # 设置页面
│   └── audio-test/        # 设备测试页面
├── static/                # 静态资源
│   ├── images/            # 图片资源
│   └── sounds/            # 声音资源
├── utils/                 # 工具函数
│   ├── metronomeService.js # 节拍器核心服务
│   ├── themeService.js    # 主题服务
│   └── audioBase64.js     # Base64编码的音频资源
├── App.vue                # 应用入口组件
├── main.js                # 应用入口文件
├── manifest.json          # 应用配置文件
├── pages.json             # 页面配置文件
├── uni.scss               # 全局样式变量
├── download-sounds.js     # 声音文件下载脚本
└── package.json           # 项目依赖配置
```

## 使用说明

### 主页面

- 滑动滑块调整速度
- 点击拍号选择器更改拍号
- 点击"开始"/"停止"按钮控制节拍器
- 点击"点击计算速度"按钮通过敲击计算所需速度

### 设置页面

- 声音类型：选择不同的声音类型
- 声音音量：调整音量大小
- 振动反馈：开启或关闭振动反馈
- 背景播放：允许在应用后台继续运行
- 默认拍号：设置应用启动时的默认拍号
- 默认速度：设置应用启动时的默认速度
- 主题颜色：更改应用主题
- 设备测试工具：打开设备测试页面

### 设备测试页面

- 音频测试：测试各种声音类型
- 振动测试：测试振动反馈
- 节拍器测试：直接测试节拍器功能

## 音频与振动

应用同时支持音频和振动两种反馈方式：
1. 音频播放：从本地文件或Base64编码音频播放声音
2. 振动反馈：强拍使用长振动，弱拍使用短振动

如果音频播放失败，应用会自动切换到振动反馈，确保在任何情况下都能提供节拍指示。

## 音频资源

应用支持多种获取音频的方式：
1. 通过`npm run download-sounds`命令从Pixabay下载音频文件
2. 手动下载音频文件并放置到`static/sounds`目录
3. 使用内置的Base64编码音频作为备选方案

## 发布

1. 使用HBuilderX发布应用到各平台
2. 支持发布到Android、iOS、H5、微信小程序等

## 贡献

欢迎提交Issue或Pull Request来改进这个项目。

## 许可证

MIT