音乐播放器的详细设计说明.docx

1、音乐播放器的详细设计说明 音乐播放器详细设计1. 引 言 随着社会的快速发展，现今社会生活紧张，而欣赏音乐是其中最好的舒缓压力的方式之一，音乐成了我们生活工作中的一个重要的部分。而3G时代的到来，手机移动应用越来越普遍。此文档就是为了能更好地设计出一个基于android系统的音乐播放器而编写的。1.1 编写目的 为软件的开发者能更好的理解和明确软件开发的详细过程，安排项目与进度、组织软件开发与测试，撰写本文档。本文档供项目组成员，软件开发人员参考。1.2项目背景本项目由李雪梅、杨挺等人提出，由本组成员联合开发，实现播放现今流行的音乐MP3等文本格式。该软件是基于Android系统的音乐播放软件

2、，并能够与其他音乐播放软件兼容。 1.3 参考资料 1 彭 重庆大学出版社软件工程“软件计划与可行性分析”2 靳岩、姚尚明 人民邮电出版社 Android开发入门与实践3 可行性分析4 音乐播放器需求分析书5 音乐播放器总体设计说明书 1.4 项目开发计划 实施计划： 阶段名称 负责人 需求分析 杨挺、李雪梅 总体设计 李雪梅、杨挺 详细设计 李雪梅、杨挺 软件测试 李雪梅、杨挺 在技术方面，编程知识比较缺乏，对有些与项目相关的软件 不熟悉，需进行人员的技术培训(自学为主)，技术难点是数据库 的构架和软件功能的设计。2. 总体设计2.1 项目目的 本项目的目的是开发一个可以播放主流的音乐文本格

3、式的播放器。设计的主要实现功能是播放MP3等格式的音乐文件，并且能控制播放，暂停，停止，音量控制，选择上一曲，选择下一曲，更改皮肤，歌曲列表文件的管理操作，在线播放，读取存储卡播放等多种播放控制，界面简明，操作简单。 软件系统检测到错误行为时，报告错误，并提示处理操作。 2.2 软件运行环境硬 件：Android操作系统手机系统软件：Android 2.2 - 4.0版本支撑软件：Eclipse 7.5 、ADT 1.5 2.3 需求概述 根据项目，我们可以获得项目系统的基本需求，从功能需求、 界面需求、性能需求、可靠性要求四个方面来描述系统的需求，再分别对各个需求进行分析。 2.4 条件与限

4、制开发人员开发经验严重不足；编程人员对开发工具不熟悉，编程经验非常有限；具备运行环境。 2.5 软件结构 3. 程序描述 3.1 歌曲界面控制 歌曲界面控制可分为：播放/暂停/停止模块、上一曲/下一曲 模块、音量模块。3.1.1 播放/暂停/停止模块 流程图： N N Y Y N Y程序逻辑： 当用户点击播放暂停停止按钮时，播放器就对当前播放事件监听从而控制当前音乐的播放暂停停止，部分关键代码如下： /播放按钮 playPauseBtn.setOnClickListener(new OnClickListener() public void onClick(View v) int cmd =

5、0; Intent i = new Intent(MusicService.MUSIC_CONTROL); /判断当前的状态值是什么状态 如果是播放状态 if (status = MusicService.STATUS_PLAYING) cmd = MusicService.CMD_PAUSE; /发送暂停的命令 else if (status = MusicService.STATUS_STOPPED) cmd = MusicService.CMD_START; /发送播放的命令 else cmd = MusicService.CMD_RESUME; /继续播放的命令 i.putExtra(

6、cmd, cmd); /将命令广播出去 sendBroadcast(i); /发送广播 );3.1.2 上一曲下一曲模块 流程图： N N Y Y程序逻辑： 当用户点击上一曲下一曲按钮时，播放器就对当前播放事件监听，从音乐列表中转换音乐，从而控制当前音乐的上一曲下一曲，关键代码如下：/上一曲键事件监听器 previousBtn.setOnClickListener (new OnClickListener() public void onClick(View v) Intent i = new Intent(MusicService.MUSIC_CONTROL); int cmd = Musi

7、cService.CMD_PREV;/发送前一首的命令 i.putExtra(cmd, cmd); sendBroadcast(i); ); / 下一曲键事件监听器 nextBtn.setOnClickListener(new OnClickListener() public void onClick(View v) Intent i = new Intent(MusicService.MUSIC_CONTROL); int cmd = MusicService.CMD_NEXT; i.putExtra(cmd, cmd); sendBroadcast(i); ); /设置SeekBar的监听

8、事件 sb.setOnSeekBarChangeListener(new OnSeekBarChangeListener() /当停止拖动时调用的方法 public void onStopTrackingTouch(SeekBar seekBar) public void onStartTrackingTouch(SeekBar seekBar) /当SeekBar拖动时会执行此方法 public void onProgressChanged(SeekBar seekBar, int prog, boolean fromUser) /fromUser参数意思是判断拖动是否是用户用手拖动的 if

9、 (fromUser = true & Math.abs(prog - progress) = 5) progress = prog; Intent i = new Intent(MusicService.MUSIC_CONTROL); int cmd = MusicService.CMD_SEEK;/发送拖动的命令 i.putExtra(cmd, cmd); i.putExtra(progress, progress);/讲拖动的进度传进Service sendBroadcast(i); sb.setProgress(progress); ); 3.1.3 音量模块流程图： N Y Y N

10、Y N 程序逻辑： 声音有两个按钮控制，一个增加声音和一个减少声音。通过 这两个按钮用户可以调节播放音乐的声音大小，用AudioManager 组件对声音的大小进行增减，最大为7，最小为0。当用户点击 声音按钮时，若是增按钮，对声音进行增加，若是减按钮对声音 进行减小。 部分代码如下： /获取点击事件 voiceUp = (ImageButton)findViewById(R.id.music_voic_up); / 音量 增加 voiceDown (ImageButton)findViewById(R.id.music_voic_down); /音量 增减小 执行事件 audiomanage

11、=(AudioManager)getSystemService( Context.AUDIO_SERVICE); voiceDown.setOnClickListener(new OnClickListener() public void onClick(View v) audiomanage.adjustVolume( AudioManager.ADJUST_LOWER,0); Volume=audiomanage.getStreamVolume( AudioManager.STREAM_RING); if(volume0) volume-; audiomanage.setRingerMod

12、e(volume); ); / 声音控制按钮 声音增加 voiceUp.setOnClickListener(new OnClickListener() public void onClick(View v) audiomanage.adjustVolume(AudioManager.ADJUST_RAISE, 0); volume=audiomanage.getStreamVolume( AudioManager.STREAM_RING); if(volume7) volume+; audiomanage.setRingerMode(volume); ); 4. 软件测试 根据制定的软件实施计划，对软件进行测试，主要目的为了找出软件中存在的各种错误和缺陷，设计出更高效的软件测试方案。 本项目的该音乐软件采用动态执行测试，对软件的功能，结构进行测试，通过运行该软件来检验程序的各个功能是否能够正确运行，各个模块之间能否进行无差错的转换，能否实现对歌曲的无差错播放，控制。