音乐播放器的详细设计

音乐播放器详细设计
1.引言
随着社会的快速发展，现今社会生活紧张，而欣赏音乐是其中最好的舒缓压力的方式之一，音乐成了我们生活工作中的一个重要的部分。

而3G时代的到来，手
机移动应用越来越普遍。

此文档就是为了能更好地设计出一个基于an droid系统的音乐播放器而编写的。

1・1编写目的
为软件的开发者能更好的理解和明确软件开发的详细过程，安排项目与进度、组织软件开发与测试，撰写本文档。

本文档供项目组成员，软件开发人员参考。

1.2项目背景
本项目由李雪梅、杨挺等人提出，由本组成员联合开发，实现播放现今流行的音乐MP3等文本格式。

该软件是基于An droid系统的音乐播放软件，并能够与其他音乐播放软件兼容。

1・3参考资料
[1] 彭龚重庆大学出版社《软件工程》“软件计划与可行性分析”
[2] 靳岩、姚尚明人民邮电出版社《Android开发入门与实践》
[3] 可行性分析
[4] 《音乐播放器需求分析书》
[5] 《音乐播放器总体设计说明书》
实施计划:
在技术方面，编程知识比较缺乏，对有些与项目相关的软件不熟悉，需进行人员的技术培训（自学为主），技术难点是数据库的构架和软件功能的设计。

2.总体设计
2.1项目目的
本项目的目的是开发一个可以播放主流的音乐文本格式的
播放器。

设计的主要实现功能是播放MP3等格式的音乐文件，并且能控制播放，暂停，停止，音量控制，选择上一曲，选择下一曲，更改皮肤，歌曲列表文件的管理操作，在线播放，读取存储卡播放等多种播放控制，界面简明，操作简单。

软件系统检测到错误行为时，报告错误，并提示处理操作。

2.2软件运行环境
硬件：An droid操作系统手机
系统软件：An droid 2.2 -- 4.0版本
支撑软件：Eclipse 7.5、ADT 1.5
根据项目，我们可以获得项目系统的基本需求，从功能需求、界面需求、性能需求、可靠性要求四个方面来描述系统的需求, 再分别对各个需求进行分析。

2.4条件与限制
开发人员开发经验严重不足；
编程人员对开发工具不熟悉，编程经验非常有限；
具备运行环境。

2.5软件结构
返回上一级
3.程序描述
歌曲界面控制可分为：播放/暂停/停止模块、上一曲/下一曲
播预畀面腔制菜单馬敵列裏
设添1除
模块、音量模块。

3.1.1播放/暂停/停止模块
程序逻辑：
当用户点击播放暂停停止按钮时，播放器就对当前播放事
件监听从而控制当前音乐的播放暂停停止，部分关键代码如下: //播放按钮
playPauseBt n.set On ClickListe ner( new On ClickListe ner() {
public void on Click(View v) {
int cmd = 0;
In te nt i = new Inten t(MusicService.MUSIC_CONTROL);
//判断当前的状态值是什么状态如果是播放状态if (status == MusicService.STATUS_PLA Yl NG) {
cmd = MusicService.CMD_PAUSE; // 发送暂停的命令} else if (status == MusicService.STATUS_STOPPED) {
cmd = MusicService.CMD_START; // 发送播放的命令
} else {
cmd = MusicService.CMD_RESUME; // 继续播放的命令}
i.putExtra("cmd", cmd); 〃将命令广播出去
sen dBroadcast(i); 〃发送广播
} });
3.1.2上一曲下一曲模块
流程图:
程序逻辑:
当用户点击上一曲下一曲按钮时，播放器就对当前播放事
件监听，从音乐列表中转换音乐，从而控制当前音乐的上一曲\
下一曲，关键代码如下：
//上一曲键事件监听器
previousBt n.set On ClickListe ner (new On ClickListe ner() {
public void on Click(View v) {
In te nt i = new Inten t(MusicService.MUSIC_CONTROL);
int cmd = MusicService.CMD_PREV;〃发送前一首的命令i.putExtra("cmd", cmd); sen dBroadcast(i);
}
});
//下一曲键事件监听器
n extBt n.set On ClickListe ner(new On ClickListe ner() {
public void on Click(View v) {
In te nt i = new Inten t(MusicService.MUSIC_CONTROL);
int cmd = MusicService.CMD_NEXT;
i.putExtra("cmd", cmd);
sen dBroadcast(i);
}
});
//设置SeekBar的监听事件
sb.set On SeekBarCha ngeListe ner( new On SeekBarCha ngeListe ner() { //当停止拖动时调用的方法
public void onStopTrackingTouch(SeekBar seekBar) { }
public void onStartTrackingTouch(SeekBar seekBar) { }
//当SeekBar拖动时会执行此方法
public void on ProgressCha nged(SeekBar seekBar, i nt prog, boolea n fromUser) {
//fromUser参数意思是判断拖动是否是用户用手拖动的
if (fromUser == true && Math.abs(prog - progress) >= 5) {
progress = prog;
Intent i = new Inten t(MusicService.MUSIC_CONTROL);
in t cmd = MusicService.CMD_SEEK;〃发送拖动的命令
i.putExtra("cmd", cmd);
i.putExtra("progress", progress);/讲拖动的进度传进Service sen
dBroadcast(i);
sb.setProgress(progress);
}
}
});
}
3.1.3音量模块
流程图：
程序逻辑:
声音有两个按钮控制，一个增加声音和一个减少声音。

通过这两个按钮用户可以调节播放音乐的声音大小，用AudioMa nager 组件对声音的大小进行增减，最大为乙最小为0。

当用户点击声音按钮时，若是增按钮，对声音进行增加，若是减按钮对声音进行减小。

部分代码如下：
//获取点击事件
voiceUp = (ImageButt on)fin dViewByld(R.id.music_voic_up);
//音量增加
voiceDown (ImageButton)findViewByld(R.id.music_voic_down); 〃音量增减小执行事件
audioma nage=(AudioMa nager)getSystemService(
Con text.AUDIO_SERVICE);
voiceDow n.set On ClickListe ner (new On ClickListe ner() { public void on Click(View v) {
audioma nage.adjust5lume(
AudioMa nager.ADJUST_LOWER,O);
Volume二audioma nage.getStreamoiume(
AudioMa nager.STREAM_RING);
if(volume>0){
volume--;
audioma nage.setR in gerMode(volume);
}
}
});
// +育控制按钮占音增加
voiceUp.set On ClickListe ner(new On ClickListe ner() {
public void on Click(View v) {
audioma nage.adjust5lume(AudioMa nager.ADJUST_RAISE, 0);
volume二audioma nage.getStreamVlume(
AudioMa nager.STREAM_RING);
if(volume<7){
volume++;
audioma nage.setR in gerMode(volume);
}
}
});
4.软件测试
根据制定的软件实施计划，对软件进行测试，主要目的为了找出软件中存在的各种错误和缺陷，设计出更高效的软件测试方案。

本项目的该音乐软件采用动态执行测试，对软件的功能，结构进行测试，通过运行该软件来检验程序的各个功能是否能够正确运行，各个模块之间能否进行无差错的转换，能否实现对歌曲的无差错播放，控制。