安卓第一阶段实训：基于存储卡的音乐播放器V03日志（周璐）

1,创建应用界面

2,设置界面布局资源（activity_main.xml)

因为代码太多，所以在这里就直接给出全部代码，需要重点注意的会单独截出来。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="20dp"
    android:background="@drawable/backgroud"
    tools:context=".ui.MainActivity">

    <ListView
        android:id="@+id/lvMusicName"
        android:layout_width="match_parent"
        android:layout_height="450dp"
        android:layout_marginBottom="16dp"
        android:layout_weight="8" />
    <TextView
        android:id="@+id/tvMusicName"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="20sp"
        android:layout_weight="0.5"
        android:textColor="#0000ff"/>
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:layout_marginBottom="10dp"
        android:layout_marginTop="10dp"
        android:layout_weight="0.5"
        android:gravity="center">

        <TextView
            android:id="@+id/tvCurrentPosition"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:textColor="#ff0000"/>

        <ProgressBar
            android:id="@+id/pbMusicProgress"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            style="?android:attr/progressBarStyleHorizontal"
            android:layout_weight="6"/>

        <TextView
            android:id="@+id/tvDuration"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:textColor="#ff00ff"/>

    </LinearLayout>
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:layout_weight="1"
        android:gravity="center">
        <Button
            android:id="@+id/btnPrevious"
            android:layout_width="60dp"
            android:layout_height="50dp"
            android:background="@drawable/previous_button_selector"
            android:onClick="doPrevious"/>
        <Button
            android:id="@+id/btnPlayOrPause"
            android:layout_width="60dp"
            android:layout_height="50dp"
            android:background="@drawable/play_button_selector"
            android:onClick="doPlayOrPause"/>
        <Button
            android:id="@+id/btnNext"
            android:layout_width="60dp"
            android:layout_height="50dp"
            android:background="@drawable/next_button_selector"
            android:onClick="doNext"/>
    </LinearLayout>
</LinearLayout>

跟上一个版本的布局多了一些东西

3，将相应的所需的图片资源放入指定的位置

4，编写有关于按钮操作的xml文件

1，pause_buttou_selector界面

2，play_button_selector界面

3，previous_button_selector界面

比上一个版本多的界面

4，next_button_selector界面

比上一个版本多的界面

5，将音频文件放入指定的地方

跟上一版本的博客一样，就不做太多的描述了。

6，创建相应的子包以及相应的类

MusicAdapter类

Music类

CommonUtils类

7，编写主界面类（MainActivity）

package net.zll.sdcard_musicplayer_v03.ui;

import android.Manifest;
import android.content.pm.PackageManager;
import android.media.MediaPlayer;
import android.os.Bundle;
import android.os.Environment;
import android.os.Handler;
import android.os.Message;
import android.view.View;
import android.widget.AdapterView;
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.zll.sdcard_musicplayer_v03.R;
import net.zll.sdcard_musicplayer_v03.adapter.MusicAdapter;
import net.zll.sdcard_musicplayer_v03.entity.Music;
import net.zll.sdcard_musicplayer_v03.util.CommonUtils;

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

/**
 * 功能：功能：基于存储卡音乐播放器V0.3
 * 作者：周璐
 * 日期：2021年01月04日
 */
public class MainActivity extends AppCompatActivity {
    private MediaPlayer mp;//媒体播放器
    private File musicDir;//音乐存放目录
    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 ListView lvMusicName;//音乐名列表控件
    private List<Music> musicList;//音乐列表（数据源）
    private MusicAdapter adapter;//音乐适配器
    private int musicIndex;//音乐索引（表明在音乐列表里的位置）

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //利用布局资源文件设置用户界面
        setContentView(R.layout.activity_main);

        //通过资源标识符获取控件实例
        lvMusicName=findViewById(R.id.lvMusicName);
        tvMusicName = findViewById(R.id.tvMusicName);
        btnPlayOrPause = findViewById(R.id.btnPlayOrPause);
        tvCurrentPosition = findViewById(R.id.tvCurrentPosition);
        tvDuration = findViewById(R.id.tvDuration);
        pbMusicProgress = findViewById(R.id.pbMusicProgress);

        //定义存储读写权限数组
        String[] PERMISSIONS_STORAGE = {
                Manifest.permission.READ_EXTERNAL_STORAGE,
                Manifest.permission.WRITE_EXTERNAL_STORAGE
        };

        //检查是否有读权限
        final int permission = ActivityCompat.checkSelfPermission(this, PERMISSIONS_STORAGE[0]);
        //如果没有权限，那么就请求读权限
        if (permission != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this, PERMISSIONS_STORAGE, 0);
        }

        //获取音乐列表（数据源）
        musicList=getMusicList();
        //判断音乐列表是否为空
        if(musicList!=null){
            //Toast.makeText(MainActivity.this,musicList.toString(),Toast.LENGTH_SHORT).show();
            //创建联系人数据
            adapter=new MusicAdapter(this,musicList);
            //给列表控件设置适配器
            lvMusicName.setAdapter(adapter);
            //获取当前要播放的音乐名(默认是音乐播放列表的第一首
            musicName=musicList.get(0).getMusicName();
            //设置音乐名标签内容，去掉扩展名，添加一个序号
            tvMusicName.setText("No."+(musicIndex+1)+" "+musicName.substring(0,musicName.lastIndexOf(".")));

            //初始化播放器
            mp = new MediaPlayer();
            try {
                //设置播放源（完整音乐名=音乐目录+音乐名）
                mp.setDataSource(musicDir.getAbsolutePath()+"/"+musicName);
                //缓冲播放源（从存储卡加载到内存）
                mp.prepare();
                //设置当前播放位置标签
                tvCurrentPosition.setText(CommonUtils.getFormatTime(mp.getCurrentPosition()));
                //设置音乐播放时长标签
                tvDuration.setText(CommonUtils.getFormatTime(mp.getDuration()));
                //数字化音乐播放进度的最大值
                pbMusicProgress.setMax(mp.getDuration());
            } catch (IOException e) {
                e.printStackTrace();
            }
            //设置线程循环控制变量为真
            isRunning=true;
            //创建子线程，定时发送消息
            thread = new Thread(new Runnable() {
                @Override
                public void run() {
                    while (isRunning){
                        //向主线程发送消息
                        handler.sendEmptyMessage(0x001);
                        try {
                            //让线程睡眠500毫秒
                            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!=null&&mp.isPlaying()){
                            //获取当前播放位置
                            currentPosition=mp.getCurrentPosition();
                            //更新音乐播放进度条的进度值
                            pbMusicProgress.setProgress(currentPosition);
                            //更新当前播放位置标签的内容
                            tvCurrentPosition.setText(CommonUtils.getFormatTime(currentPosition));
                        }
                    }
                }
            };
            //给音乐列表控件注册监听器
            lvMusicName.setOnItemClickListener(new AdapterView.OnItemClickListener() {
                @Override
                public void onItemClick(AdapterView<?> adapterView, View view, int position, long id) {
                    //获取音乐索引
                    musicIndex=position;
                    //当前播放位置归零
                    currentPosition=0;
                    try {
                        //调用播放方法  
                        play();
                    } catch (IOException e) {
                        e.printStackTrace();
                    }
                }
            });

            //给媒体播放器注册完成监听器
            mp.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {
                @Override
                public void onCompletion(MediaPlayer mediaPlayer) {
                    try {
                        //切换到下一首
                        nextMusic();
                    } catch (IOException e) {
                        e.printStackTrace();
                    }
                }
            });
        }else {
            //提示用户没有音乐文件
            Toast.makeText(MainActivity.this,"外置存储卡Music目录里没有音乐文件！",Toast.LENGTH_SHORT).show();
        }
     }
    //播放方法
    private void play() throws IOException {
        //重置媒体播放器
        mp.reset();
        //获取当前播放的音乐名
        musicName=musicList.get(musicIndex).getMusicName();
        //设置音乐名标签内容，去掉扩展名，添加一个序号
        tvMusicName.setText("No."+(musicIndex+1)+" "+musicName.substring(0,musicName.lastIndexOf(".")));
        //设置播放源（完整音乐名=音乐目录+音乐名）
        mp.setDataSource(musicDir.getAbsolutePath()+"/"+musicName);
        //缓冲播放源（从存储卡加载到内存）
        mp.prepare();
        //设置当前播放位置标签
        tvCurrentPosition.setText(CommonUtils.getFormatTime(mp.getCurrentPosition()));
        //设置音乐播放时长标签
        tvDuration.setText(CommonUtils.getFormatTime(mp.getDuration()));
        //数字化音乐播放进度的最大值
        pbMusicProgress.setMax(mp.getDuration());
        //定位到暂停时的播放的位置
        mp.seekTo(currentPosition);
        //启动音乐的播放
        mp.start();
        //按钮图标由【播放】图标切换到【暂停】图标
        btnPlayOrPause.setBackgroundResource(R.drawable.pause_button_selector);
    }
    //暂停方法
    private void pause(){
        //暂停播放
        mp.pause();
        //保存音乐播放的当前位置
        currentPosition=mp.getCurrentPosition();
        //按钮图标由【暂停】图标切换到【播放】图标
        btnPlayOrPause.setBackgroundResource(R.drawable.play_button_selector);
    }
    //播放|暂停按钮按钮单击事件处理方法
    public void doPlayOrPause(View view) throws IOException {
        //判断音乐是否在播放
        if(mp.isPlaying()){
            //暂停音乐
            pause();
        }else {
            //播放音乐
            play();
        }
    }
    //下一首音乐
    private void nextMusic() throws IOException {
        //更新音乐索引
        if(musicIndex < musicList.size() -1){
            musicIndex++;
        }else{
            musicIndex=0;//第一首
        }
        //当前播放位置归零
        currentPosition=0;
        //调用播放方法
        play();
    }

    //上一首音乐
    private void previousMusic() throws IOException {
        //更新音乐索引
        if(musicIndex > 0){
            musicIndex--;
        }else{
            musicIndex=musicList.size()-1;//最后一首
        }
        //当前播放位置归零
        currentPosition=0;
        //调用播放方法
        play();
    }

    //上一首单击事件处理方法
    public void doPrevious(View view) throws IOException {
        previousMusic();
    }

    //下一首单击事件处理方法
    public void doNext(View view) throws IOException {
        nextMusic();
    }

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

    private List<Music> getMusicList(){
        //获取音乐存放目录
        musicDir= Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_MUSIC);
        //定义音乐名数组
        String[] musicNames=musicDir.list();
        //判断音乐存放目录下是否有音乐文件
        if(musicNames.length>0){
            //创建音乐列表对象
            musicList=new ArrayList<>();
            //遍历音乐名数组
            for(int i=0;i<musicNames.length;i++){
                //创建音乐实体
                Music music=new Music();
                //设置音乐实体属性
                music.setMusicName(musicNames[i]);
                //将音乐实体添加到音乐名数组
                musicList.add(music);
            }
        }else {
            Toast.makeText(MainActivity.this,"外置存储卡Music目录里没有音乐文件！",Toast.LENGTH_SHORT).show();
        }
        //返回音乐列表
        return musicList;
    }
}

添加了上一首和下一首相关的代码，其余地方也产生了一些小的变动。

8，AndroidManifest.xml界面

9，打开应用查看效果

应用成功运行，能放出音乐，有进度条，有音乐列表，可以进行下一首上一首的切换，本版本的想要实现的功能实现。

10，总结

本次实训的V03版本与上一个V02版本比起来多了不少的功能，切换上一首与下一首、音乐列表（不再是一首音乐），布局也有了较大的改变，比上一个版本的更加的像一个音乐播放器一点。
本交实训学习了如何 从指定目录得到文件，还不是很理解，下来有待进行复习。