Android实训日志：基于外部存储的音乐播放器V06
目录
- 项目功能
- 实现步骤
-
- 创建安卓应用
- 将图片素材放入drawable和mipmap
- 创建按钮背景图片选择器
- 在项目清单文件里授权访问外置存储卡，设置应用程序图标
- 创建anim包里面创建animator.xml
- 主布局资源文件activity_main.xml
- 布局文件activity_splash_screen_activity.xml
- 字符串资源文件strings.xml
- 创建音乐名列表项模板music_name_list_item.xml
- 创建ui子包，将MainActivity拖进ui子包
- 创建entity子包，在里面创建音乐实体类 - Music
- 创建app子包，在里面创建音乐播放器应用程序类 - MusicPlayerApplication
- 给音乐播放器应用程序类注册
- 创建adapter子包，在里面创建音乐适配器 - MusicAdapter
- 在app子包常见应用程序常量接口 - AppConstants
- 创建service子包，在里面创建音乐播放服务类 - MusicPlayService
- 主界面类 - MainActivity
- 在ui子包里创建SplashScreenActivity（启动画面）
- 运行效果
项目功能
- 在基于存储卡音乐播放器V0.5基础上，作如下修改：
1、添加启动画面（SplashScreenActivity）
2、添加音乐播放幕式功能：顺序播放、随机播放、单曲循环播放
3、将进度条（ProgressBar）改为拖拽条（SeekBar），用户通过拖拽可自行设置音乐播放进度值
实现步骤
创建安卓应用
将图片素材放入drawable和mipmap
创建按钮背景图片选择器
在项目清单文件里授权访问外置存储卡，设置应用程序图标
创建anim包里面创建animator.xml
主布局资源文件activity_main.xml
布局文件activity_splash_screen_activity.xml
字符串资源文件strings.xml
创建音乐名列表项模板music_name_list_item.xml
创建ui子包，将MainActivity拖进ui子包
创建entity子包，在里面创建音乐实体类 - Music
创建app子包，在里面创建音乐播放器应用程序类 - MusicPlayerApplication
package com.zjs.sdcard_music_player_v06.app;
import android.app.Application;
import android.os.Environment;
import com.zjs.sdcard_music_player_v06.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; // 简单日期格式
private int currentMusicIndex;//当前音乐索引
private int currentPosition;//当前播放位置
private int playMode;//播放模式
private int progressChangedByUser;//用户修改的播放进度
@Override
public void onCreate() {
super.onCreate();
// 实例化简单日期格式
sdf = new SimpleDateFormat("mm:ss");
}
public int getCurrentMusicIndex() {
return currentMusicIndex;
}
public void setCurrentMusicIndex(int currentMusicIndex) {
this.currentMusicIndex = currentMusicIndex;
}
public int getCurrentPosition() {
return currentPosition;
}
public void setCurrentPosition(int currentPosition) {
this.currentPosition = currentPosition;
}
public int getPlayMode() {
return playMode;
}
public void setPlayMode(int playMode) {
this.playMode = playMode;
}
public int getProgressChangedByUser() {
return progressChangedByUser;
}
public void setProgressChangedByUser(int progressChangedByUser) {
this.progressChangedByUser = progressChangedByUser;
}
/**
* 获取格式化时间
*
* @param time 单位是毫秒
* @return 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 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 getMusicList() {
// 声明音乐列表
List musicList = null;
// 获取外置存储卡根目录
File sdRootDir = Environment.getExternalStorageDirectory();
// 创建后缀字符串
String suffix = ".mp3";
// 创建音乐文件列表
List 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;
}
}
给音乐播放器应用程序类注册
创建adapter子包，在里面创建音乐适配器 - MusicAdapter
package com.zjs.sdcard_music_player_v06.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 com.zjs.sdcard_music_player_v06.R;
import java.util.List;
public class MusicAdapter extends BaseAdapter {
private Context context; // 上下文
private List musicList; // 音乐列表
/**
* 构造方法
*
* @param context
* @param musicList
*/
public MusicAdapter(Context context, List musicList) {
this.context = context;
this.musicList = musicList;
}
@Override
public int getCount() {
return musicList.size();
}
@Override
public Object getItem(int position) {
return musicList.get(position);
}
@Override
public long getItemId(int position) {
return position;
}
@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();
}
// 获取列表项要显示的数据
com.zjs.sdcard_music_player_v06.entity.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;
}
}
在app子包常见应用程序常量接口 - AppConstants
package com.zjs.sdcard_music_player_v06.app;
public interface AppConstants {
String TAG = "net.hw.sdcard_musicplayer_v06"; // 应用程序标记
String INTENT_ACTION_PREVIOUS = TAG + ".intent.action.PREVIOUS"; // 广播频道常量：播放上一首
String INTENT_ACTION_PLAY = TAG + ".intent.action.PLAY"; // 广播频道常量：播放
String INTENT_ACTION_PLAY_OR_PAUSE = TAG + ".intent.action.PLAY_OR_PAUSE"; // 广播频道常量：播放或暂停
String INTENT_ACTION_NEXT = TAG + ".intent.action.NEXT"; // 广播频道常量：播放下一首
String INTENT_ACTION_UPDATE_PROGRESS = TAG + ".intent.action.UPDATE_PROGRESS"; // 广播频道常量：更新播放进度
String INTENT_ACTION_USER_CHANGE_PROGRESS = TAG + ".intent.action.USER_CHANGE_PROGRESS";//广播频道常量：用户改变播放进度
String CONTROL_ICON = "control_icon"; // 控制图标名称常量
String DURATION = "duration"; // 播放时长名称常量
String CURRENT_POSITION = "current_position"; // 当前播放位置名称常量
int PLAY_MODE_ORDER = 0;//播放模式：顺序播放
int PLAY_MODE_RANDOM = 1;//播放模式：随机播放
int PLAY_MODE_LOOP = 2;//播放模式：单曲循环
}
创建service子包，在里面创建音乐播放服务类 - MusicPlayService
主界面类 - MainActivity
package com.zjs.sdcard_music_player_v06.ui;
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.AsyncTask;
import android.os.Bundle;
import android.view.View;
import android.widget.AdapterView;
import android.widget.Button;
import android.widget.ListView;
import android.widget.ProgressBar;
import android.widget.RadioGroup;
import android.widget.SeekBar;
import android.widget.TextView;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import com.zjs.sdcard_music_player_v06.R;
import com.zjs.sdcard_music_player_v06.adapter.MusicAdapter;
import com.zjs.sdcard_music_player_v06.app.AppConstants;
import com.zjs.sdcard_music_player_v06.app.MusicPlayerApplication;
import com.zjs.sdcard_music_player_v06.service.MusicPlayService;
import java.util.List;
public class MainActivity extends AppCompatActivity implements AppConstants {
private String musicName; // 音乐文件名
private TextView tvMusicName; // 音乐名标签
private Button btnPlayOrPause; // 播放|暂停按钮
private MusicReceiver receiver;//音乐广播接收器
private TextView tvCurrentPosition; // 显示当前播放位置的标签
private TextView tvDuration; // 显示音乐播放时长的标签
private SeekBar sbMusicProgress;//音乐播放拖拽条
private ListView lvMusicName; // 音乐名列表控件
private List musicList; // 音乐列表（数据源）
private MusicAdapter adapter; // 音乐适配器
private MusicPlayerApplication app; // 音乐播放器应用程序对象
private ProgressBar pbScanMusic; // 扫描存储卡音乐进度条
private TextView tvScanMusic; // 扫描存储卡音乐标签（提示用户耐心等待）
private RadioGroup rgPlayMode;//播放模式单选按钮组
@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);
pbScanMusic = findViewById(R.id.pbScanMusic);
tvScanMusic = findViewById(R.id.tvScanMusic);
sbMusicProgress = findViewById(R.id.sb_music_progress);
rgPlayMode = findViewById(R.id.rg_play_mode);
// 获取音乐播放器应用程序对象
app = (MusicPlayerApplication) getApplication();
// 定义存储读写权限数组
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);
return;
}
//执行填充音乐列表的异步任务
new FillMusicListTask().execute();
// 给音乐列表控件注册监听器
lvMusicName.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView adapterView, View view, int position, long id) {
// 获取音乐索引
app.setCurrentMusicIndex(position);
// 当前播放位置归零
app.setCurrentPosition(0);
// 获取音乐名
musicName = app.getMusicList().get(position).getMusicName();
// 设置音乐名标签内容，去掉路径和扩展名，添加序号
tvMusicName.setText("No." + (app.getCurrentMusicIndex() + 1) + "" + musicName.substring(
musicName.lastIndexOf("/") + 1, musicName.lastIndexOf(".")));
//创建意图
Intent intent = new Intent();
//设置广播频道：播放
intent.setAction(INTENT_ACTION_PLAY);
//按意图发送广播
sendBroadcast(intent);
}
});
// 给播放模式单选按钮组注册监听器
rgPlayMode.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() {
@Override
public void onCheckedChanged(RadioGroup radioGroup, int checkedId) {
// 判断用户选择何种播放模式
switch (checkedId) {
// 顺序播放模式
case R.id.rb_order:
app.setPlayMode(PLAY_MODE_ORDER);
break;
// 随机播放模式
case R.id.rb_random:
app.setPlayMode(PLAY_MODE_RANDOM);
break;
// 单曲循环模式
case R.id.rb_loop:
app.setPlayMode(PLAY_MODE_LOOP);
break;
}
}
});
// 给音乐播放拖拽条注册监听器
sbMusicProgress.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
@Override
public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
// 判断进度是否为用户修改
if (fromUser) {
// 设置用户修改的播放进度
app.setProgressChangedByUser(progress);
// 创建意图
Intent intent = new Intent();
// 设置广播频道：用户修改播放进度
intent.setAction(INTENT_ACTION_USER_CHANGE_PROGRESS);
// 按意图发送广播
sendBroadcast(intent);
}
}
@Override
public void onStartTrackingTouch(SeekBar seekBar) {
}
@Override
public void onStopTrackingTouch(SeekBar seekBar) {
}
});
//创建音乐广播接收器
receiver = new MusicReceiver();
//创建意图过滤器
IntentFilter filter = new IntentFilter();
//通过意图过滤器添加广播频道
filter.addAction(INTENT_ACTION_UPDATE_PROGRESS);
//注册音乐广播接收器
registerReceiver(receiver,filter);
}
/**
* 填充音乐列表异步任务类
*/
private class FillMusicListTask extends AsyncTask {
/**
* 耗时工作执行前
*/
@Override
protected void onPreExecute() {
super.onPreExecute();
// 显示扫描音乐进度条
pbScanMusic.setVisibility(View.VISIBLE);
// 显示扫描音乐标签
tvScanMusic.setVisibility(View.VISIBLE);
}
@Override
protected Void doInBackground(Void... voids) {
// 获取音乐列表
musicList = app.getMusicList();
// 故意耗时，要不然扫描太快结束
for (long i = 0; i < 2000000000; i++) {
}
return null;
}
/**
* 耗时工作执行后
*
* @param aVoid
*/
@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." + (app.getCurrentMusicIndex() +1)+""+musicName.substring(
musicName.lastIndexOf("/")+1,musicName.lastIndexOf(".")));
//创建意图，用于启动音乐服务
Intent intent = new Intent(MainActivity.this, MusicPlayService.class);
//按意图启动服务
startService(intent);
} else {
// 提示用户没有音乐文件
Toast.makeText(MainActivity.this, "外置存储卡上没有音乐文件！", Toast.LENGTH_SHORT);
}
}
}
/**
* 音乐广播接收器
*/
private class MusicReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent){
//获取广播频道
String action = intent.getAction();
//判断广播频道是否为空
if (action != null){
//根据不同广播频道执行不同操作
if(INTENT_ACTION_UPDATE_PROGRESS.equals(action)){
//获取播放时长
int duration = intent.getIntExtra(DURATION,0);
//获取播放控制图标
int controLIcon = intent.getIntExtra(CONTROL_ICON,
R.drawable.play_button_selector);
//计算进度值
int progress = app.getCurrentPosition() * 100 / duration;
//获取音乐名
musicName = app.getMusicList().get(app.getCurrentMusicIndex()).getMusicName();
//设置正在播放的文件名（去掉扩展名）
tvMusicName.setText("No." + (app.getCurrentMusicIndex() +1)+""+musicName.substring(
musicName.lastIndexOf("/")+1,musicName.lastIndexOf(".")));
//设置播放进度值标签
tvCurrentPosition.setText(app.getFormatTime(app.getCurrentPosition()));
//设置播放时长标签
tvDuration.setText(app.getFormatTime(duration));
// 设置播放拖拽条的进度值
sbMusicProgress.setProgress(progress);
//设置【播放|暂停】按钮显示的图标
btnPlayOrPause.setBackgroundResource(controLIcon);
}
}
}
}
/**
* 上一首按钮单击事件处理方法
*
* @param view
*/
public void doPrevious(View view) {
//创建意图
Intent intent = new Intent();
//设置广播频道
intent.setAction(INTENT_ACTION_PREVIOUS);
//按意图发送广播
sendBroadcast(intent);
}
/**
* 下一首按钮单击事件处理方法
*
* @param view
*/
public void doNext(View view) {
//创建意图
Intent intent = new Intent();
//设置广播频道
intent.setAction(INTENT_ACTION_NEXT);
//按意图发送广播
sendBroadcast(intent);
}
/**
* 播放|暂停按钮单击事件处理方法
*
* @param view
*/
public void doPlayOrPause(View view) {
//创建意图
Intent intent = new Intent();
//设置广播频道
intent.setAction(INTENT_ACTION_PLAY_OR_PAUSE);
//按意图发送广播
sendBroadcast(intent);
}
/**
* 销毁回调方法
*/
@Override
protected void onDestroy() {
super.onDestroy();
//停止音乐播放服务
stopService(new Intent(MainActivity.this, MusicPlayService.class));
//注销广播接收器
if(receiver != null){
unregisterReceiver(receiver);
}
}
}
在ui子包里创建SplashScreenActivity（启动画面）
package com.zjs.sdcard_music_player_v06.ui;
import android.content.Intent;
import android.os.Bundle;
import android.view.animation.Animation;
import android.view.animation.AnimationUtils;
import android.widget.ImageView;
import androidx.appcompat.app.AppCompatActivity;
import com.zjs.sdcard_music_player_v06.R;
public class SplashScreenActivity extends AppCompatActivity {
private Animation animation;//动画对象
private ImageView ivMusicIcon;//音乐图标图像控件
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 利用布局资源文件设置用户界面
setContentView(R.layout.activity_splash_screen_activity);
// 通过资源标识获得控件实例
ivMusicIcon = findViewById(R.id.iv_music_icon);
// 加载动画资源文件，创建动画对象
animation = AnimationUtils.loadAnimation(this, R.anim.animator);
// 让音乐图标图像控件启动动画
ivMusicIcon.startAnimation(animation);
// 给动画对象设置监听器
animation.setAnimationListener(new Animation.AnimationListener() {
@Override
public void onAnimationStart(Animation animation) {
}
@Override
public void onAnimationEnd(Animation animation) {
// 启动主界面
startActivity(new Intent(SplashScreenActivity.this, MainActivity.class));
// 关闭启动界面
finish();
}
@Override
public void onAnimationRepeat(Animation animation) {
}
});
}
}
运行效果
