安卓第一阶段实训项目：基于存储卡音乐播放器V0.4----实训报告（四）

安卓第一阶段实训项目：基于存储卡音乐播放器V0.4----实训报告（四）

功能要求

在基于存储卡音乐播放器V0.3基础上，作如下修改：

1. 创建方法能扫描存储卡上所有mp3文件（采用递归算法） ----完成
2. 用自定义应用程序类存放全局数据和方法 ----完成
3. 利用异步任务来完成耗时的存储卡扫描工作----完成

说明：模拟器存储卡上目录少，扫描很快就完成，几乎看不到等待的进度条，最好在真机上运行程序进行测试。----真机测试不读目录可能和安卓版本太高有关，测试设备安卓11.

一、运行效果

二、实现步骤

1.创建安卓应用【SDCardMusicPlayerV0.4】

2.将图片素材拷贝到drawable目录与mipmap目录

3.播放按钮背景图片选择器 - play_button_selector.xml

去我上一篇看吧

4.暂停按钮背景图片选择器 - pause_button_selector.xml

去我上一篇看吧

5.上一首按钮背景图片选择器 - previous_button_selector.xml

去我上一篇看吧

6.下一首按钮背景图片选择器 - next_button_selector.xml

去我上一篇看吧

7.主布局资源文件activity_main.xml

去我上一篇看吧

8.字符串资源文件strings.xml

<resources>
    <string name="app_name">基于存储卡音乐播放器V0.4</string>
    <string name="scan_music">扫描外置存储卡上全部MP3音乐，请耐心等待……</string>
</resources>

9.创建音乐名列表项模板music_name_list_item.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="10dp">

    <TextView
        android:id="@+id/tvMusicName"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="20sp"/>
</LinearLayout>

10.创建ui子包，将MainActivity拖进ui子包

11.创建entity子包，在里面创建音乐实体类Music

package net.yq.sdcardmusicplayerv04.entity;

public class Music {
    private String musicName; // 音乐名

    public String getMusicName() {
        return musicName;
    }

    public void setMusicName(String musicName) {
        this.musicName = musicName;
    }

    @Override
    public String toString() {
        return "Music{" +
                "musicName='" + musicName + '\'' +
                '}';
    }
}

12.创建app子包，在里面创建音乐播放器应用程序类MusicPlayerApplication

package net.yq.sdcardmusicplayerv04.app;

import android.app.Application;
import android.os.Environment;

import net.yq.sdcardmusicplayerv04.entity.Music;

import java.io.File;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.List;

public class MusicPlayerApplication extends Application {
    private SimpleDateFormat sdf;//简单日期格式

    @Override
    public void onCreate() {
        super.onCreate();
        sdf = new SimpleDateFormat("mm:ss");
    }

    public String getFormatTime(int time) {
        return sdf.format(time);

    }

    /**
     * 生成指定目录下某种文件的文件列表
     *
     * @param dir
     * @param suffix
     * @param typeFileList
     */
    public void makeTypeFileList(File dir, String suffix, List<String> typeFileList) {
        //获取指定目录下的File数组（File既可以指向目录，也可以指向文件）
        File[] files = dir.listFiles();
        //遍历File数组
        for (File file : files) {
            //判断file是否是文件
            if (file.isFile()) {//file是文件
                //按照后缀过滤文件
                if (file.getName().endsWith(suffix)) {
                    //将满足条件的文件添加到文件列表
                    typeFileList.add(file.getAbsolutePath());
                }
            } else {//file是目录
                //目录为空，递归调用
                if (file.list() != null) {
                    makeTypeFileList(file, suffix, typeFileList);
                }
            }
        }
    }

    /**
     * 获取音乐列表
     * @return
     */
    public List<Music> getMusicList(){
        //声明音乐列表
        List<Music> musicList= null;
        //获取外置存储卡目录
        File sdRootDir = Environment.getExternalStorageDirectory();
        //创建后缀字符串
        String suffix = ".mp3";
        //创建音乐文件列表
        List<String> musicFileList = new ArrayList<>();
        //调用方法，生成指定目录下某种类型文件列表
        makeTypeFileList(sdRootDir,suffix,musicFileList);
        //判断音乐文件列表元素是否有元素
        if (musicFileList.size()>0){
            // 实例化音乐列表
            musicList = new ArrayList<>();
            //遍历音乐文件列表
            for (String musicFile : musicFileList){
                //创建音乐实体
                Music music =new Music();
                //设置实体属性
                music.setMusicName(musicFile);
                //将音乐实体添加到音乐列表
                musicList.add(music);
            }
        }

        //返回音乐列表
        return musicList;
    }
}

13.在项目清单文件里个音乐播放器应用程序类注册并授权读外置存储卡

14.创建adapter子包，在里面创建音乐适配器MusicAdapter

package net.yq.sdcardmusicplayerv04.adapter;

import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.TextView;

import net.yq.sdcardmusicplayerv04.R;
import net.yq.sdcardmusicplayerv04.entity.Music;

import java.util.List;

/**
 * 音乐适配器
 **/
public class MusicAdapter extends BaseAdapter {

    private final Context context; // 上下文
    private final List<Music> musicList;// 音乐列表

    /**
     * 构造方法
     *
     * @param context
     * @param musicList
     */
    public MusicAdapter(Context context, List<Music> musicList) {
        this.context = context;
        this.musicList = musicList;
    }

    /**
     * 个数
     *
     * @return
     */
    @Override
    public int getCount() {
        return musicList.size();
    }

    /**
     * 列表项
     *
     * @param position
     * @return
     */
    @Override
    public Object getItem(int position) {
        return musicList.get(position);
    }

    /**
     * 列表项id
     *
     * @param position
     * @return
     */
    @Override
    public long getItemId(int position) {
        return position;
    }

    /**
     * 列表项视图
     *
     * @param position
     * @param convertView
     * @param parent
     * @return
     */
    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        // 声明视图容器
        ViewHolder holder = null;

        // 判断转换视图是否为空
        if (convertView == null) {
            // 将列表项模板映射成转换视图
            convertView = LayoutInflater.from(context).inflate(R.layout.music_name_list_item, null);
            // 创建视图容器对象
            holder = new ViewHolder();
            // 实例化转换视图里的控件
            holder.tvMusicName = convertView.findViewById(R.id.tvMusicName);
            // 将视图容器附加到转换视图
            convertView.setTag(holder);
        } else {
            // 从转换视图里取出视图容器
            holder = (ViewHolder) convertView.getTag();
        }

        // 获取列表项要显示的数据
        Music music = musicList.get(position);
        // 设置列表项控件的属性(去掉路径和扩展名)
        holder.tvMusicName.setText(music.getMusicName().substring(music.getMusicName().lastIndexOf("/") + 1, music.getMusicName().lastIndexOf(".")));

        // 返回转换视图
        return convertView;
    }

    /**
     * 视图容器
     */
    private static class ViewHolder {
        TextView tvMusicName;
    }
}

15.主界面类 - MainActivity

package net.yq.sdcardmusicplayerv04.ui;

import android.Manifest;
import android.content.pm.PackageManager;
import android.media.MediaPlayer;
import android.os.AsyncTask;
import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.view.View;
import android.widget.Button;
import android.widget.ListView;
import android.widget.ProgressBar;
import android.widget.TextView;
import android.widget.Toast;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;

import net.yq.sdcardmusicplayerv04.R;
import net.yq.sdcardmusicplayerv04.adapter.MusicAdapter;
import net.yq.sdcardmusicplayerv04.app.MusicPlayerApplication;
import net.yq.sdcardmusicplayerv04.entity.Music;

import java.io.IOException;
import java.util.List;

public class MainActivity extends AppCompatActivity {
    private MediaPlayer mp; // 媒体播放器
    private String musicName; // 音乐文件名
    private TextView tvMusicName; // 音乐名标签
    private Button btnPlayOrPause; // 播放|暂停按钮
    private int currentPosition; // 音乐当前播放位置
    private TextView tvCurrentPosition; // 显示当前播放位置的标签
    private TextView tvDuration; // 显示音乐播放时长的标签
    private ProgressBar pbMusicProgress; // 音乐播放进度条
    private Thread thread; // 线程
    private Handler handler; // 消息处理器
    private boolean isRunning; // 线程循环控制变量
    private List<Music> musicList;//音乐数据源
    private ListView lvMusicName;//音乐名控件列表
    private MusicAdapter adapter;
    private int musicIndex;//
    private MusicPlayerApplication app;//音乐播放器应用程序
    private ProgressBar pbScanMusic;//扫描存储卡进度条
    private TextView tvScanMusic;//扫描存储卡音乐标签

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //获取控件实例
        lvMusicName = findViewById(R.id.lvMusicName);
        btnPlayOrPause = findViewById(R.id.btnPlayOrPause);
        tvMusicName = findViewById(R.id.tvMusicName);
        tvCurrentPosition = findViewById(R.id.tvCurrentPosition);
        tvDuration = findViewById(R.id.tvDuration);
        pbMusicProgress = findViewById(R.id.pbMusicProgress);
        pbScanMusic = findViewById(R.id.pbScanMusic);
        tvScanMusic = findViewById(R.id.tvScanMusic);
        //初始化播放器
        mp = new MediaPlayer();
        //获取音乐播放器应用程序对象
        app = (MusicPlayerApplication) getApplication();
        // 定义存储读写权限数组
        String[] PERMISSIONS_STORAGE = {
                Manifest.permission.READ_EXTERNAL_STORAGE,
                Manifest.permission.WRITE_EXTERNAL_STORAGE
        };
        // 检查是否有读权限
        int permission = ActivityCompat.checkSelfPermission(this, PERMISSIONS_STORAGE[0]);
        // 如果没有授权，那么就请求读权限
        if (permission != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this, PERMISSIONS_STORAGE, 0);
            return;
        }
        //启动填充音乐播放列表异步任务
        new FillMusicListTask().execute();
        //设置循环变量为真
        isRunning = true;
        //创建子线程，定时发送消息
        thread = new Thread(new Runnable() {
            @Override
            public void run() {
                while (isRunning) {
                    handler.sendEmptyMessage(0x001);
                    try {
                        Thread.sleep(500);
                    } catch (InterruptedException e) {
                        e.printStackTrace();
                    }
                }
            }
        });
        //启动子线程
        thread.start();
        //创建消息处理器，接受子线程发送的消息
        handler = new Handler() {
            @Override
            public void handleMessage(@NonNull Message msg) {
                super.handleMessage(msg);
                if (msg.what == 0x001) {
                    if (mp.isPlaying()) {
                        currentPosition = mp.getCurrentPosition();
                        pbMusicProgress.setProgress(currentPosition);
                        tvCurrentPosition.setText(app.getFormatTime(currentPosition));
                    }
                }
            }
        };
        //设置监听器
        lvMusicName.setOnItemClickListener((adapterView, view, position, id) -> {
            //获取索引
            musicIndex = position;
            //进度归零
            currentPosition = 0;
            try {
                MainActivity.this.play();
            } catch (IOException e) {
                e.printStackTrace();
            }
        });
        mp.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {
            @Override
            public void onCompletion(MediaPlayer mediaPlayer) {
                //当前音乐播放完毕,切换下一首
                try {
                    //下一曲
                    MainActivity.this.nextMusic();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        });
    }

    /**
     * 填充音乐列表异步任务类
     */
    private class FillMusicListTask extends AsyncTask<Void, Integer, Void> {
        /**
         * 耗时工作执行前
         */
        @Override
        protected void onPreExecute() {
            super.onPreExecute();
            //设置进度条属性
            pbScanMusic.setVisibility(View.VISIBLE);
            //设置文字属性
            tvScanMusic.setVisibility(View.VISIBLE);
        }

        protected Void doInBackground(Void... voids) {
            musicList = app.getMusicList();
            for (long i = 0; i < 2000000000; i++) {
            }
            return null;
        }

        @Override
        protected void onPostExecute(Void aVoid) {
            super.onPostExecute(aVoid);
            pbScanMusic.setVisibility(View.GONE);
            tvScanMusic.setVisibility(View.GONE);
            //判断列表是否为空
            if (musicList.size() > 0) {
                //创建适配器
                adapter = new MusicAdapter(MainActivity.this, musicList);
                //设置适配器
                lvMusicName.setAdapter(adapter);
                //获取音乐名标签内容（默认为第一首）
                musicName = musicList.get(0).getMusicName();
                //设置播放音乐名
                tvMusicName.setText("No." + (musicIndex + 1) + " " + musicName.substring(
                        musicName.lastIndexOf("/") + 1, musicName.lastIndexOf(".")));
                mp = new MediaPlayer();
                try {
                    //设置播放源
                    mp.setDataSource(musicName);
                    // 缓冲播放源（从存储卡加载到内存）
                    mp.prepare();
                    //设置当前播放位置标签
                    tvCurrentPosition.setText(app.getFormatTime(mp.getCurrentPosition()));
                    //设置音乐播放时长标签
                    tvDuration.setText(app.getFormatTime(mp.getDuration()));
                    //获取进度条最大值
                    pbMusicProgress.setMax(mp.getDuration());
                } catch (IOException e) {
                    e.printStackTrace();
                }
            } else {
                Toast.makeText(MainActivity.this, "存储卡Music目录里没有音乐文件！", Toast.LENGTH_SHORT).show();
            }
        }
    }


    //方法定义开始
    /**
     * 上一曲
     */
    private void previousMusic() throws IOException{
        //更新索引
        if (musicIndex>0){
            musicIndex--;
        }else {
            musicIndex = musicList.size() -1;
        }
        //位置归零
        currentPosition = 0;
        //调用播放方法
        play();
    }

    /**
     * 播放方法
     */
    private void play() throws IOException {
        // 重置媒体播放器
        mp.reset();
        //获取当前播放的音乐名
        musicName = musicList.get(musicIndex).getMusicName();
        //设置播放音乐名
        tvMusicName.setText("No." + (musicIndex + 1) + " " + musicName.substring( musicName.lastIndexOf("/") + 1, musicName.lastIndexOf(".")));
        // 设置播放源（完整音乐名 = 音乐目录 + 音乐名）
        mp.setDataSource(musicName);
        // 缓冲播放源（从存储卡加载到内存）
        mp.prepare();
        //设置当前播放位置标签
        tvCurrentPosition.setText(app.getFormatTime(mp.getCurrentPosition()));
        //设置音乐播放时长标签
        tvDuration.setText(app.getFormatTime(mp.getDuration()));
        //获取进度条最大值
        pbMusicProgress.setMax(mp.getDuration());
        // 定位到暂停时的播放位置
        mp.seekTo(currentPosition);
        // 启动音乐的播放
        mp.start();
        // 按钮图标由【播放】图标切换到【暂停】图标
        btnPlayOrPause.setBackgroundResource(R.drawable.pause_button_selector);
    }

    /**
     * 下一曲
     */
    private void nextMusic() throws IOException{
        //更新索引
        if (musicIndex<musicList.size() -1){
            musicIndex++;
        }else {
            musicIndex =0;
        }
        //播放位置归零
        currentPosition = 0;
        play();
    }

    /**
     * 暂停方法
     */
    private void pause() {
        // 暂停播放
        mp.pause();
        // 保存音乐播放的当前位置
        currentPosition = mp.getCurrentPosition();
        // 按钮图标由【暂停】图标切换到【播放】图标
        btnPlayOrPause.setBackgroundResource(R.drawable.play_button_selector);
    }

    /**
     * 上一曲按钮处理方法
     * @param view
     * @throws IOException
     */
    public void doPrevious(View view) throws IOException{
        previousMusic();
    }

    /**
     * 播放|暂停按钮单击事件处理方法
     *
     * @param view
     */
    public void doPlayOrPause(View view) throws IOException {
        // 判断音乐是否在播放
        if (mp.isPlaying()) {
            // 暂停音乐
            pause();
        } else {
            // 播放音乐
            play();
        }
    }

    /**
     * 下一曲按钮处理方法
     */
    public void doNext(View view) throws IOException{
        nextMusic();
    }

    /**
     * 销毁回调方法，释放资源
     */
    @Override
    protected void onDestroy() {
        super.onDestroy();
        isRunning = false;
        thread = null;
        // 判断音乐是否在播放
        if (mp != null && mp.isPlaying()) {
            mp.stop();
        }
        // 释放媒体播放器
        mp.release();
        // 销毁媒体播放器
        mp = null;
    }
}

总结

以上就是0.4版本的报告，总体感觉在0.3上改进，变动不大。并且，自主改进难度不高。