文章目录


从这篇文章开始我们将做一个音乐播放器,来播放手机中的音乐,功能包括音乐列表展示、上一首、下一首、播放、暂停等基本功能。

准备工作

首先在手机的 Music 文件夹下放入几首歌
【达内课程】音乐播放器v1.0(上)_ide
【达内课程】音乐播放器v1.0(上)_ide_02

读取手机Music中的音乐

新建 MusicApplication 项目,AndroidManifest.xml 中增加读取外部存储权限

<!-- 读取外部存储权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

运行项目后记得在设置中打开该权限
【达内课程】音乐播放器v1.0(上)_xml_03
MainActivity 中

public class MainActivity extends AppCompatActivity {

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

//【目标】扫描手机中Music文件夹,获取所有歌曲信息
//1、获取Music文件夹的File对象
//2、检查Music文件夹是否存在
//3、获取Music文件夹下的文件列表
//4、检查文件列表是否有效
//5、遍历文件列表
//5.1、检查是否是文件
//5.2、检查是否是mp3文件
File musicDir = Environment.getExternalStoragePublicDirectory
(Environment.DIRECTORY_MUSIC);

if (musicDir.exists()) {
Log.d("MUSIC", "【信息】文件夹存在");
File[] files = musicDir.listFiles();
if (files != null && files.length > 0) {
Log.d("MUSIC", "【信息】文件夹列表有效");
for (int i = 0; i < files.length; i++) {
if (files[i].isFile()) {
String fileName = files[i].getName();
if (fileName.toLowerCase().endsWith(".mp3")) {
Log.d("MUSIC", files[i].getAbsolutePath());
} else {
Log.w("MUSIC", "【错误】当前遍历到的不是mp3文件");
}
} else {
Log.w("MUSIC", "【错误】当前遍历到的第" + i + "个不是文件");
}
}
} else {
Log.w("MUSIC", "【错误】文件夹列表无效");
}
} else {
Log.w("MUSIC", "【错误】文件夹不存在");
}
}
}

运行程序查看 Log 输出
【达内课程】音乐播放器v1.0(上)_android_04

展示音乐列表

【达内课程】音乐播放器v1.0(上)_ide_05

布局 activity_main.xml 中添加一个 ListView 用于展示音乐列表

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

<ListView
android:id="@+id/listview"
android:layout_width="match_parent"
android:layout_height="match_parent" />

</RelativeLayout>

增加 Music 类,用于表示音乐信息,包括路径和标题。

public class Music {
private String path;
private String title;

public String getTitle() {
return title;
}

public void setTitle(String title) {
this.title = title;
}

public String getPath() {
return path;
}

public void setPath(String path) {
this.path = path;
}

@Override
public String toString() {
return "Music Title [" + title + "] Music Path [" + path + "]";
}
}

增加 item_music.xml 用于展示 ListView 每条的样式

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:padding="10dp">

<TextView
android:id="@+id/tv_music_title"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:maxLines="1"
android:text="title"
android:textColor="#222222"
android:textSize="15dp" />

<TextView
android:id="@+id/tv_music_path"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:layout_below="@+id/tv_music_title"
android:maxLines="1"
android:text="path......"
android:textColor="#999999"
android:textSize="15dp" />
</RelativeLayout>

MainActivity.java

public class MainActivity extends AppCompatActivity {
private ListView listView;
private MusicAdapter adapter;

//音乐列表
private List<Music> musics;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

//初始化控件
initView();
//获取数据
getData();
}

private void initView() {
listView = findViewById(R.id.listview);
musics = new ArrayList<Music>();
adapter = new MusicAdapter(this,musics);
listView.setAdapter(adapter);
}

private void getData() {
File musicDir = Environment.getExternalStoragePublicDirectory
(Environment.DIRECTORY_MUSIC);

if (musicDir.exists()) {
Log.d("MUSIC", "【信息】文件夹存在");
File[] files = musicDir.listFiles();
if (files != null && files.length > 0) {
Log.d("MUSIC", "【信息】文件夹列表有效");
for (int i = 0; i < files.length; i++) {
if (files[i].isFile()) {
String fileName = files[i].getName();
if (fileName.toLowerCase().endsWith(".mp3")) {
Music music = new Music();
music.setPath(files[i].getAbsolutePath());
music.setTitle(files[i].getName());
musics.add(music);
Log.d("MUSIC", files[i].getAbsolutePath());
} else {
Log.w("MUSIC", "【错误】当前遍历到的不是mp3文件");
}

} else {
Log.w("MUSIC", "【错误】当前遍历到的第" + i + "个不是文件");
}
}
} else {
Log.w("MUSIC", "【错误】文件夹列表无效");
}
} else {
Log.w("MUSIC", "【错误】文件夹不存在");
}
}
}

MusicAdapter

public class MusicAdapter extends BaseAdapter {
private List<Music> data;
private Context context;

public MusicAdapter(Context context, List<Music> data) {
this.context = context;
this.data = data;
}


@Override
public int getCount() {
return data.size();
}

@Override
public Object getItem(int position) {
return data.get(position);
}

@Override
public long getItemId(int position) {
return position;
}

@Override
public View getView(int position, View convertView, ViewGroup parent) {
if (convertView == null) {
convertView = LayoutInflater.from(context).inflate(R.layout.item_music, null);
}

Music music = data.get(position);
TextView tv_music_path = convertView.findViewById(R.id.tv_music_path);
TextView tv_music_title = convertView.findViewById(R.id.tv_music_title);
tv_music_path.setText(music.getPath());
String fileName = music.getTitle();
tv_music_title.setText(fileName.substring(0, fileName.lastIndexOf(".")));

return convertView;
}
}

拓展:Environment类

Environment 类是专门用于访问外部存储的工具类,该类提供了一系列的静态方法与常量,便于访问外部存储。

每个手机都有 sdcard,不管你的手机是 32GB 或者 64GB,手机把这些存储空间分为了主存储空间和扩展存储空间,那么这个扩展存储空间就是 sdcard,所以 sdcard不一定是sd卡片。

​File getExternalStorage()​​​获取 sdcard 的文件对象
​​​File getExternalStoragePublicDirectory(String)​​​获得用于存储特定类型文件的顶层共享或外部存储器目录。例如 Music 文件夹的 File 对象,参数为Environment类的常量:​​DIRECTORY_MUSIC​

不同手机上 sdcard 路径不同,为了保证都能找到 sdcard 路径,所以我们像上面栗子中写的:

File musicDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_MUSIC);

而不是

String musicPath = "/storage/emulated/0/Music/";
File musicDir = new File(musicPath);

​String getExternalStorageState();​​​获取 sdcard 的状态,如果 sdcard 已经正常挂载可以使用,则返回的值应该与 Environment 中的常量​​MEDIA_MOUNTED​​是匹配的