# SimpleMusic

**Repository Path**: DLX4/SimpleMusic

## Basic Information

- **Project Name**: SimpleMusic
- **Description**: 一个简单的Android音乐播放器
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2020-07-26
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SimpleMusic

## 1. 开发环境
- AndroidStudio 3.2
- AndroidSDK 5.0
- gradle 4.6

## 2. 模块划分

| 模块 | 简要说明 |
|--|--|
| 后台服务(Service) | 提供音乐播放的基本功能, 对外提供播放控制和列表操作的接口 |
| 主界面 | 展示我的音乐歌单, 可以对歌单里的音乐进行播放, 删除等操作 |
| 本地音乐 | 展示本地音乐列表, 提供对本地音乐的读取, 并且可以播放, 添加收藏, 删除 |
| 在线音乐 | 展示当前热门歌曲, 提供播放，添加收藏，删除等功能，需要时可以刷新列表 |
| 播放器界面 | 展示当前音乐的信息, 控制播放模式, 上一曲, 播放/暂停, 下一曲，以及查看和操作当前播放列表 |

## 3. 实现功能
1. 展示出本地的所有音乐文件，并显示相关信息
2. 对本地音乐进行播放, 添加歌单, 删除等操作
3. 播放过程中，可以暂停播放、恢复播放、上一首、下一首、拖动音乐进度条到任意时间点播放
4. 播放时，能显示当前播放音乐的进度，指示播放的时间, 并加载专辑图片
5. 可以设置播放的顺序为顺序播放、单曲循环、随机播放等等
6. 音乐播放器等界面退出以后，音乐仍然能在后台播放
7. 每次启动音乐播放器，播放器装载之前的播放列表，并把列表中的第一首音乐作为默认的首播曲
8. 再次打开播放器，能显示当前音乐的实时信息
9. 可以连接到网络，播放网络上的音乐
10. 缓存网络音乐列表, 需要时刷新, 也可以添加歌单或者移除
11. 音频焦点控制, 被其他音频打断后能继续播放

## 4. 简要说明

### 各java文件的作用
| 文件名 | 功能 |
|--|--|
| /java/useLitepal/*.java | litepal采用对象映射操作数据库, 每个文件对应一张表 |
| /java/widget/RotateAnimator.java | 唱盘动画制作 |
| /java/Music.java | 音乐类 |
| /java/MusicAdapter.java | 音乐列表显示音乐的适配器 |
| /java/PlayingMusicAdapter.java | 播放列表显示音乐的适配器 |
| /java/SplashActivity.java | 欢迎界面 |
| /java/MainActivity.java | 主界面 |
| /java/LocalMusicActivity.java | 本地音乐界面 |
| /java/OlineMusicActivity.java | 在线音乐界面 |
| /java/PlayerActivity.java | 播放器界面 |
| /java/MusicService.java | 音乐服务 |
| /java/Utils.java | 工具类, 封装了一些常用操作 |

### 各xml文件的作用
| 文件名 | 功能 |
|--|--|
| /res/anim/*.xml | Activity切换动画 |
| /res/layout/activity_splash.xml | 欢迎界面布局 |
| /res/layout/ activity_main.xml | 主界面布局 |
| /res/layout/ activity_localmusic.xml | 本地音乐界面布局 |
| /res/layout/ activity_onlinemusic.xml | 在线音乐界面布局 |
| /res/layout/ activity_player.xml | 播放器界面布局 |
| /res/layout/music_item.xml | 音乐列表项布局 |
| /res/layout/playinglist_item.xml | 播放列表项布局 |
| /res/layout/layout_discview.xml | 播放器唱盘布局 |
| /res/layout/nav_header.xml | 侧拉菜单头布局 |
| /res/menu/main.xml | 主界面活动跳转菜单布局 |
| /res/menu/nav_menu.xml | 侧拉菜单项布局 |

## 5. 效果图
<img src="screenshots/播放器.png" width = "22%"/>
<img src="screenshots/我的音乐.png" width = "22%"/>
<img src="screenshots/本地音乐.png" width = "22%"/>
<img src="screenshots/在线音乐.png" width = "22%"/>