Android项目实践(四)——音乐播放器APP

关于Android制作音乐播放器APP的几点建议

1.权限获得

1.在AndroidManifest.xml文件中，做如下声明：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.INTERNET"/>

其中：
(1)"android.permission.READ_EXTERNAL_STORAGE"获取读取外部存储的权限，
(2)"android.permission.WRITE_EXTERNAL_STORAGE"获取写入外部存储的权限
(3)"android.permission.ACCESS_FINE_LOCATION"获取程序访问精良位置(如GPS)的权限，
(4)"android.permission.INTERNET"获取程序联网的权限。

2.歌曲存放

1.对于本地歌曲，需要存放在SD卡下的Music目录下。找到Android Studio右侧的Device File Explorer(需要保证Android模拟机为开启状态)，具体路径为：mnt–>sdcard–>Music(其余路径也可以，这个比较合适而已)，右键Music目录，选择Upload上传.mp3文件；
2. 对于下载歌曲，下载完成后同样可以放在这个位置。首先定义路径如下：

public static final File PATH = Environment.getExternalStoragePublicDirectory("/Music");

此方法获得了到Music一级的目录，在之后下载歌曲的存储用到此地址，

File file = new File(PATH, fileName + ".mp3");

新建一个以.mp3为名字的文件，这个文件是在Music/下。当我们下载成功一首歌曲时，获取歌曲名字为fileName.mp3并存储在此位置，之后经过读取，可将下载好的歌曲同本地歌曲一起读取到歌曲列表中。

3.歌曲下载

1.歌曲下载可以申请QQ音乐等API，但需要进行返回的json数据解析，此处不深度分析；
2.对于此APP的音乐下载功能，是通过网址直接下载，歌曲浏览及下载网址为：Free Music Archive
但在APP中下载时，我们并不是打开这个网址进行点击下载，而是通过输入歌曲名称进行下载，因此我们需要了解网站下载的地址规律。观察可以发现一部分歌曲的下载格式为：

"https://freemusicarchive.org/track/" + path +"/download";

其中path为输入的歌曲名称经转换后的格式(举例：输入的歌曲名称为"Love is Here"，转化后的path=“Love-is-Here”)，具体转换如下，当接收到输入框输入的歌曲名称时：

String pathOld = song.getText().toString();
	String pathNew=null;
    int index = pathOld.indexOf(" ");
    if(index == -1){
    	pathNew = pathOld;
    }else{
        String[] x = pathOld.split(" ");
        pathNew = x[0];
        for(int i=1; i<x.length;i++) {
        	pathNew = pathNew + "-" + x[i];
        }
    }
String pathLast = "https://freemusicarchive.org/track/" + pathNew +"/download";

当下载完成，需要存储到SD卡下的Music目录时，需要将歌曲名称提取出来，转换如下：

final String url = intent.getStringExtra("path");
    String str = url.substring(0,url.indexOf("/download"));
    fileName=str.substring(str.lastIndexOf("/")+1);
    int index = fileName.indexOf("-");
    if(index == -1){
    	fileNameNew = fileName;
    }else{
    	String[] x = fileName.split("-");
        fileNameNew = x[0];
        for(int i=1; i<x.length; i++){
        	fileNameNew = fileNameNew + " " + x[i];
        }
    }
File file = new File(PATH, fileNameNew + ".mp3");

4.服务声明

1.音乐播放器需要用到服务(Service)，比如我的APP写了2个service：一个用于歌曲的播放、暂停、进度条等功能的实现，命名为MusicService，另一个用于下载歌曲功能的实现，命名为DownMusicService。这两个service需要在AndroidManifest.xml中进行声明，才可应用，声明如下：

<service android:name="com.example.musicplayer.MusicService"
	tools:ignore="Instantiatable">
</service>
<service android:name="com.example.musicplayer.DownMusicService">
</service>

其中"com.example.musicPlayer"为自己的包名，及为Service所在的绝对路径。

5.页面跳转

1.由于此APP只有主界面，通过搜索下载歌曲之后，仍然需要返回到主界面，所以可以通过对“搜索”按钮进行点击事件的声明，点击“搜索”后跳转到DownMusicService进行歌曲下载的处理，代码如下：

Intent intent = new Intent(MainActivity.this, DownMusicService.class);
intent.putExtra("path",pathLast);
startService(intent);

其中path为下载路径，通过intent.putExtra函数传到DownMusicService服务，当歌曲下载完成后，需要返回到主界面，代码如下：

Intent intentNew = new Intent(DownMusicService.this, MainActivity.class);
intentNew.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK );
startActivity(intentNew);

通过重启MianActivity，实现对Music目录的重新扫描，这样下载的歌曲便也会显示在主界面(由于歌曲下载需要一定时间，但从DownMusicService返回到MainActivity的时间较短，有时候返回到主界面新下载的歌曲并不能及时显示，因此设置一个刷新按钮)。刷新按钮的点击响应事件如下：

Button refresh = findViewById(R.id.refresh);
refresh.setOnClickListener(new View.OnClickListener() {
	@Override
	public void onClick(View v) {
    	try {
        	Intent intent1 = getIntent();
            finish();
            startActivity(intent1);
        }catch (Exception e){
            Log.i("TAG","刷新失败!");
            }
        }
    });

6.下载链接

最后，附上音乐播放器APP的github地址，代码仍不完善，欢迎借鉴和指正。
MusicPlayer