Android 音乐播放器制作(带有通知栏、Widget小挂件)

Android 音乐播放器制作(带有通知栏显示、Widget小挂件)

我用的开发工具是AndroidStudio，我的手机是Android7.1.2，我的另一个测试手机是Android8.0. 整个项目完整代码放在文章末尾。
本项目已同步上传到我的GitHub：https://github.com/2604150210/JalMusic

进入公司的第一个任务就是写一个音乐播放器（给定时间是两个星期）
对我来说还挺难的?毕竟之前还从没写过这么复杂的APP呢，不过只有挑战自己不会的东西才有意义嘛?才能得到进步。
在第二周的时候，我突然明白了为啥来公司前两星期就让我做一个播放器了，因为一个音乐播放器就要用到好多知识，Android的四大组件全都用到了，还学习了怎样实现进程间通信和异步更新UI，以及Widget的使用。

一、项目演示

1. 录屏演示

我录制了三个视频，可是CSDN里面居然不支持上传视频，唉唉唉???我决定把演示视频和代码放到压缩包里一起放在文末链接中。

2. 截屏显示

3. 项目结构

二、使用技术

1. Activity

Activity是对用户可见的UI界面，用户与应用程序都是通过Activity来进行交互的。Activity的生命周期如下：

我的这个音乐播放器项目中只用到了两个Activity，因为我的APP比较简单，只有两个页面，一个是音乐列表MainActivity，一个是详情页DetailActivity。其中onCreate()方法是Activity的入口方法，每一个Activity的实例创建时都会调用onCreate()方法，在这个方法中我们可以做一些初始化操作，如申请权限，初始化UI等。

我在MainActivity初始化的过程中，还不争气地入了坑，由于我刚开始是用我的手机测试的，我的手机是不需要动态获取权限的，直接在manifest中写的，但是在Android8.0的手机上运行却会闪退，是因为Android8.0需要动态获取权限，而我在MainActivity中调用了MusicList类中的静态方法getMusicData(context)，这个方法是用来读取手机里面的mp3文件的，但是我刚开始没有动态申请权限，所以在8.0的手机上就闪退了。

Activity的UI初始化和申请权限是两个异步的事件，如果你的UI必须依赖于成功申请权限的话，建议你把UI初始化语句写在成功申请权限后的回调函数onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults)中。 如我的UI显示依赖获取READ_EXTERNAL_STORAGE权限，要不然就无法读取到手机的mp3文件，主页面就是空白了。

我的初始化UI的代码都写在了initView()中了，initView()在申请权限成功时得到调用。
由于我的MainActivity刚打开的时候，如果没有打开的歌曲则底部不显示东西，如果有已暂停或正在播放的歌曲，则在底部显示当前打开的歌曲名，所以我的MainActivity刚开始的时候如果点ListView其中的某一个Item进入到DetailActivity中后，当用户从DetailActivity返回出来时，MainActivity应该在底部显示刚才点击的歌曲，而歌曲列表还要显示当前正在播放的歌曲，所以ListView的布局就应该改变了。我在此处的处理是重新加载UI布局，也就是在onResume()中重新调用initView(),之所以在onResume()中调用initView是和Activity的生命周期有关的，由于退回到MainActivity中的时候，这个页面重新被激活，应该是从onStop()->onRestart()->onStart()->onPause(),而不经过onCreate()了，所以写在onCreate中是不可能会重新初始化UI的，而写在onPause()中的话，每次进入音乐列表都会先初始化UI，通过判断当前有无打开的歌曲来决定调用哪一套Item布局。

• MainActivity.java

package com.jal.www.jalmusic;

import android.Manifest;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.content.pm.PackageManager;
import android.os.Bundle;
import android.os.Handler;
import android.support.annotation.NonNull;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;
import android.widget.AdapterView;
import android.widget.LinearLayout;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.Toast;

import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {
   
    private ListView listView;
    private LinearLayout cur_music;
    private TextView tv_main_title;
    private ArrayList<Music> listMusic;
    private String TAG = "MainActivityLog";
    private MyReceiver myReceiver;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
   
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        myReceiver = new MyReceiver(new Handler());
        IntentFilter itFilter = new IntentFilter();
        itFilter.addAction(MusicService.MAIN_UPDATE_UI);
        registerReceiver(myReceiver, itFilter);
        requestPermission();
     }
    private void initView() {
   
        listView = this.findViewById(R.id.listView1);
        listMusic = MusicList.getMusicData(getApplicationContext());
        Log.i(TAG, "listMusic.size()=="+listMusic.size());
        MusicAdapter adapter = new MusicAdapter(this, listMusic);
        listView.setAdapter(adapter);
        listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
   
            @Override
            public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
   
                Bundle bundle = new Bundle();
                bundle.putParcelableArrayList("listMusic",listMusic);
                bundle.putInt("position", position);
                Intent intent = new Intent();
                intent.putExtras(bundle);
                intent.setClass(MainActivity.this, DetailsActivity.class);
                startActivity(intent);
            }
        });
        cur_music = findViewById(R.id.cur_music);
        tv_main_title = findViewById(R.id.tv_main_title);
        if(MusicService.mlastPlayer != null){
   
            tv_main_title.setText(listMusic.get(MusicService.mPosition).getName());
        }
    }

    private class MyReceiver extends BroadcastReceiver {
   
        private final Handler handler;
        // Handler used to execute code on the UI thread
        public MyReceiver(Handler handler) {
   
            this.handler = handler;
        }

        @Override
        public void onReceive(final Context context, final Intent intent) {
   
            // Post the UI updating code to our Handler
            handler.post(new Runnable() {
   
                @Override
                public void run() {
   
                    initView();
                }
            });
        }
    }
    @Override
    protected void onResume() {
   
        initView();
        if (MusicService.mlastPlayer != null){
   
            cur_music.setVisibility(View.VISIBLE);
            tv_main_title = findViewById(R.id.tv_main_title);
            tv_main_title.setText(listMusic.get(MusicService.mPosition).getName());
            cur_music.setOnClickListener(new View.OnClickListener() {
   
                @Override
                public void onClick(View v) {
   
                    Bundle bundle = new Bundle();
                    int position = MusicService.mPosition;
                    bundle.putInt("position", position);
                    Intent intent = new Intent();
                    intent.putExtras(bundle);
                    intent.setClass(MainActivity.this, DetailsActivity.class);
                    startActivity(intent);
                }
            });
        }else{
   
            cur_music.setVisibility(View.GONE);
        }
        super.onResume();
    }


    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
   
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        switch (requestCode) {
   
            case 1:
                if (grantResults.length > 0){
   
                    for (int i = 0; i < grantResults.length; i++) {
   

                        int grantResult = grantResults[i];
                        if (grantResult == PackageManager.PERMISSION_DENIED){
   
                            String s = permissions[i];
                            Toast.makeText(this,s+"权限被拒绝了",Toast.LENGTH_SHORT).show();
                        }else{
   
                            initView();
                        }
                    }
                }
                break;
            default:
                break;
        }
    }
    private void requestPermission(){
   

        List<String> permissionList = new ArrayList<>();
        if (ContextCompat.checkSelfPermission(this,Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED){
   
            permissionList.add(Manifest.permission.READ_EXTERNAL_STORAGE);
        }

        if (ContextCompat.checkSelfPermission(this,Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED){
   
            permissionList.add(Manifest.permission.WRITE_EXTERNAL_STORAGE);
        }

        if (!permissionList.isEmpty()){
   
            ActivityCompat.requestPermissions(this,permissionList.toArray(new String[permissionList.size()]),1);
        }else {
   
            initView();
        }
    }
}

• DetailActivity.java

package com.jal.www.jalmusic;

import android.content.BroadcastReceiver;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.content.ServiceConnection;
import android.os.Bundle;
import android.os.Handler;
import android.os.IBinder;
import android.os.Message;
import android.support.annotation.Nullable;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.ImageView;
import android.widget.SeekBar;
import android.widget.TextView;

import java.util.ArrayList;

public class DetailsActivity extends AppCompatActivity implements View.OnClickListener {
   
    private MyConnection conn;
    private String TAG = "DetailsActivity";
    private Button btn_pre;
    private Button btn_play;
    private Button btn_next;
    private ImageView btn_return;
    private SeekBar seekBar;
    private MusicButton imageView;
    private TextView tv_title,tv_cur_time,tv_total_time;
    private MusicService.MyBinder musicControl;
    private static final int UPDATE_UI = 0;
    private ArrayList<Music> listMusic;

    MyReceiver myReceiver;
    private Handler handler = new Handler() {
   
        @Override
        public void handleMessage(Message msg) {
   
            switch (msg.what) {
   
                case UPDATE_UI:
                    updateUI();
                    break;
            }
        }
    };

    public DetailsActivity() {
   
    }

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
   
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_details);
        listMusic = MusicList.getMusicData(this);
        Intent intent = new Intent(this, MusicService.class);
        Bundle bundle = getIntent().getExtras();
        intent.putExtras(bundle);
        conn = new MyConnection();
        startService(intent);
        bindService(intent, conn, BIND_AUTO_CREATE);

        myReceiver = new MyReceiver(new Handler());
        IntentFilter itFilter = new IntentFilter();
        itFilter.addAction(MusicService.MAIN_UPDATE_UI);
        getApplicationContext().registerReceiver(myReceiver, itFilter