# 音乐播放器：VibePlayer（Android app）

**Repository Path**: Aurora_th/vibe-player

## Basic Information

- **Project Name**: 音乐播放器：VibePlayer（Android app）
- **Description**: VibePlayer是一款功能强大的Android音乐播放器应用，专为音乐爱好者设计，提供了丰富的音乐播放和管理功能。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-06-08
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VibePlayer

VibePlayer是一款功能强大的Android音乐播放器应用，专为音乐爱好者设计，提供了丰富的音乐播放和管理功能。

![示例截图](issues/示例图片/示例1.png)

## 功能特点

### 音乐播放
- 支持多种播放模式：顺序播放、单曲循环、列表循环、随机播放
- 前台服务保证后台播放稳定运行

### 音乐库管理
- 自动扫描设备中的音乐文件
- 支持文件浏览器手动导入音乐
- 播放列表创建和管理

![示例截图](issues/示例图片/示例2.png)

### 音频处理
- 内置均衡器，支持多种预设
- 低音增强和虚拟环绕声效果
- 支持音频可视化

![示例截图](issues/示例图片/示例3.png)

### 歌词功能
- 歌词编辑器，支持添加时间戳
- 歌词实时同步显示
- 歌词预览功能

### 用户界面
- 现代化UI设计
- 支持深色/浅色主题切换
- 响应式布局，适配不同尺寸设备
- 直观的播放控制界面

## 权限说明

应用需要以下权限才能正常工作：
- 读取媒体音频（Android 13及以上）
- 读取外部存储（Android 13以下）
- 前台服务
- 通知权限（可选）
- 媒体内容控制

## 系统要求

- Android 5.0 (API级别21)或更高版本
- 建议安装在Android 8.0或更高版本上获得最佳体验

## 使用指南

### 首次使用
1. 启动应用后，系统会请求必要的权限
2. 授予权限后，应用会自动扫描设备中的音乐文件
3. 若未找到音乐文件，可使用内置的文件浏览器导入音乐

### 播放控制
- 底部控制栏提供基本播放控制
- 点击正在播放的歌曲可进入全屏播放界面
- 左右滑动可切换歌曲
- 长按歌曲可查看更多选项

### 播放列表管理
- 点击"+"按钮创建新播放列表
- 长按歌曲可添加到播放列表
- 在播放列表详情页可管理列表内歌曲

### 均衡器设置
- 在均衡器页面可启用/禁用音效处理
- 选择预设或自定义均衡器设置
- 调整低音增强和虚拟环绕声效果

### 歌词编辑
1. 在全屏播放界面点击歌词编辑按钮
2. 输入歌词内容，每行一句
3. 播放歌曲，在适当的时间点点击"添加时间戳"
4. 保存歌词后可在播放界面同步显示

## 技术特点

- 使用MediaPlayer和MediaSession管理音乐播放
- 支持MediaBrowserService实现跨组件媒体控制
- 采用Room数据库存储播放列表和歌曲信息
- 利用Fragment和ViewPager实现多页面导航
- 前台服务确保后台播放稳定性
- 适配Android不同版本的权限处理

![示例截图](issues/示例图片/示例4.png)