基于Android平台的音乐播放器设计报告v3.0

题目： 基于Android平台的音乐播放器设计报告 学生姓名： 何双双 学 号： 12108010851 指导教师： 邓江沙目录第一章 引 言1 1.1 项目背景1 1.2 编写目的1第二章 系统需求分析2 2.1 功能需求（用例图分析）2 2.1.1 播放器的用例图2 2.1.2用例分析3第三章 概要设计4 3.1软件播放流程图4 3.2 软件类图5第四章 详细设计6 4.1MusicInfoController类6 4.1.1.类启动6 4.1.2.服务绑定activity6 4.2MusicInfoController类6 4.2.1获得播放文件列表7 4.3MusicList类7 4.3.1播放7 4.3.2暂停/播放7 4.3.3停止8 4.4MusicPlayerApp类8 4.4.1单例模式8第五章 系统实现10 5.1软件部署10 5.2启动软件10 5.3播放界面11第六章 结 论12附录一： 代码13 1.获取全部音频文件代码13 2.绑定歌曲列表到listview控件13 3.软件初始化14 4.音乐播放服务15第一章 引 言1.1 项目背景当今社会的生活节奏越来越快，人们对手机的要求也越来越高，由于手机市场发展迅速，使得手机操作系统也出现了不同各类，现在的市场上主要有三个手机操作系统，Windows mobile，symbian，以及谷歌的Android操作系统，其中占有开放源代码优势的Android系统有最大的发展前景。那么能否在手机上拥有自己编写的个性音乐播放器呢？能的，谷歌Android系统就能做到。本文的音乐播放器就是基于谷歌Android手机平台的播放器。Android：是谷歌于2007年公布的开放式源代码手机系统，它的开放性就优于其它封闭式的手机系统，因此，任何人都可能根据自己的喜好将手机系统中的所有功能重新编写。这使得越来越多的人关注这个操作系统。本次作品音乐播放器就是基于Android平台的。1.2 编写目的现今社会生活紧张，而欣赏音乐是其中最好的舒缓压力的方式之一，本项目的目的是开发一个可以播放主流音乐文件格式的播放器，本设计实现的主要功能是播放Mp3，Wav多种格式的音乐文件，并且能够控制播放，暂停，停止，播放列等基本播放控制功能，界面简明，操作简单。 本项目是一款基于Android手机平台的音乐播放器，使Android手机拥有个性的多媒体播放器，使手机显得更生动灵活化，与人们更为接近，让手机主人随时随地处于音乐视频的旋律之中。使人们的生活更加多样化。也使设计者更加熟练Android的技术和其它在市场上的特点。第二章 系统需求分析2.1 功能需求（用例图分析）根据项目的目标，我们可获得项目系统的基本需求，以下从不同角度来描述系统的需求，并且使用用例图来描述，系统的功能需求，我们分成四部分来概括，即播放器的基本控制需要，播放列表管理需求，播放器友好性需求和播放器扩展卡需求。以下分别描述：2.1.1 播放器的用例图假设安装了音乐播放器的用户是系统的主要设计对象，其拥有以下操作，启动软件、播放音乐、暂停播放、停止播放、退出软件，其用例图如下图2.1 播放器基本用例图2.1.2用例分析用例名称：启动软件参与者：用户目标：使得用户启动软件并加载手机和sd卡上的音频文件到播放列表前置条件：无基本事件流：1.用户启动软件 2.播放器将播放列表中的当前的歌曲用例名称：播放参与者：用户目标：使得用户可以播放在播放列表中选中的歌曲前置条件：播放器正在运行基本事件流：1.用户单击“播放”按钮 2.播放器将播放列表中的当前的歌曲用例名称：暂停参与者：用户目标：使得用户可以暂停正在播放的歌曲前置条件：歌曲正在播放且未停止和暂停基本事件流：1.用户单击“暂停”按钮 2.播放器将暂停当前的歌曲用例名称：停止参与者：用户目标：使得用户可以停止正在播放的歌曲前置条件：歌曲正在播放或暂停基本事件流：1.用户单击“停止”按钮 2.播放器将停止当前播放的歌曲用例名称：推出参与者：用户目标：使得用户退出或者后台播放音乐前置条件：程序在运行基本事件流：1.用户按返回键 2.播放器退出或者进入后台播放第三章 概要设计3.1软件播放流程图Step1.启动软件后，软件自动检索手机和sd卡的音频文件，并组织显示成列表.Step2.点击列表的歌曲名字。Step3.播放音乐。Step4.点击暂停，音乐暂停Step5.点击播放 转到step3Step6.点击停止 停止播放音乐Step7.点击退出，若音乐处于播放状态，则音乐转向后台播放，界面退出。Step8.点击退户，若音乐处于暂停或者停止状态，直接退出。图3.1音乐播放器流程图3.2 软件类图系统设计了4个类，分别是播放音乐的服务类MusicPlayerService；主要用于获取android系统中的音频文件，并提供访问接口的MusicInfoController类；继承于ListActivity，主要用于显示歌曲列表的MusicList类和程序的生存类MusicPlayerApp类。音乐播放器类MusicInfoController类MusicList类MusicPlayerApp类MusicPlayerService图3.2 软件类图图3.2音乐播放器类图第四章 详细设计4.1MusicInfoController类这个类继承于service，是播放音乐的服务类。播放音乐，暂停音乐，停止播放等操作都封装在这个类中。主要的执行动作有：4.1.1.类启动onCreate() mMediaPlayer = new MediaPlayer();/分配一个播放对象mMediaPlayer.setOnPreparedListener(mPrepareListener);/绑定之前mMediaPlayer.setOnCompletionListener(mCompleteListener);/绑定之后4.1.2.服务绑定activity MediaPlayer.OnCompletionListener mCompleteListener = new MediaPlayer.OnCompletionListener() /实例化一个绑定监听器的匿名类 public void onCompletion(MediaPlayer mp) /完成绑定后 broadcastEvent(PLAY_COMPLETED);/广播消息 ;4.2MusicInfoController类这个类主要用于获取android系统中的音频文件，并提供访问接口，它是一个单例类。4.2.1获得播放文件列表private Cursor query(Uri uri, String prjs, String selections, String selectArgs, String order)ContentResolver resolver = pApp.getContentResolver();/取得一个连接对象if (resolver = null)return null;return resolver.query(uri, prjs, selections, selectArgs, order);public Cursor getAllSongs()return query(MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, null, null, null, MediaStore.Audio.Media.DEFAULT_SORT_ORDER);/查询ContentResolver 的所有音频文件4.3MusicList类改类继承于ListActivity，主要用于显示歌曲列表，并且封装部分操作，以及与父级目标通信。4.3.1播放 protected void onListItemClick(ListView l, View v, int position, long id) /歌曲列表的某项被点击 super.onListItemClick(l, v, position, id); if (mCursor = null |mCursor.getCount() = 0) return; mCursor.moveToPosition(position);/游标移动到当前路径 String url = mCursor.getString(mCursor .getColumnIndexOrThrow(MediaStore.Audio.Media.DATA);/取得绝对路径 mMusicPlayerService.setDataSource(url);/传递绝对路径 mMusicPlayerService.start();/播放音乐 4.3.2暂停/播放 mPlayPauseButton.setOnClickListener(new Button.OnClickListener() public void onClick(View v) if (mMusicPlayerService != null & mMusicPlayerService.isPlaying() mMusicPlayerService.pause();/音乐播放的服务暂停 mPlayPauseButton.setText(R.string.play);/改变按钮文字 else if (mMusicPlayerService != null) mMusicPlayerService.start();/如果已经是暂停，则播放音乐 mPlayPauseButton.setText(R.string.pause);/改变文字 );4.3.3停止 mStopButton.setOnClickListener(new Button.OnClickListener() public void onClick(View v) / Perform action on click if (mMusicPlayerService != null ) mTextView.setVisibility(View.VISIBLE);/改变文字状态 mPlayPauseButton.setVisibility(View.INVISIBLE);/隐藏按钮 mStopButton.setVisibility(View.INVISIBLE);/隐藏停止按钮 mMusicPlayerService.stop();/后台音乐停止播放 );4.4MusicPlayerApp类该类继承与Application，是程序的生存类。可以标识音乐播放器的生命周期，包括音乐在后台播放等。4.4.1单例模式public void onCreate()super.onCreate();mMusicInfoController = MusicInfoController.getInstance(this); /返回该类的一个唯一实例public MusicInfoController getMusicInfoController()return mMusicInfoController;第5章 系统实现5.1软件部署系统编译生成apk文件，将apk文件拷到手机或者sd卡中，直接打开即可安装，或者安装360手机助手通过usb调试的方式进行安装。图5.1软件图标5.2启动软件启动软件后，加载歌曲列表现在这个界面上，如01表示歌曲名，unknown表示歌曲的演唱者图5.2软件启动界面5.3播放界面从加载的歌曲列表中点击要播放的歌曲，开始播放图5.3 音乐播放界面第六章 结 论(1) 通过对Android手机平台的音乐播放器软件的开发，使我对Android音乐播放器系统的整体设计有一个深入的了解，对整个流程也会有一个清晰的认识。开发Android音乐播放器，要抓住开发的核心部分，音乐播放器大体由播放主界面、播放列表、菜单、播放设置、文件浏览、歌曲搜索六大核心组成。(3) 本次程序设计，对播放器的系统结构框架做了精心的构思与设计，采用主要开发工具是Eclips4.0+Java语言的支持，Android Development Tool的插件，和Android SDK2.1版本的全面结合，才使整个音乐播放器系统得以实现。附录一： 代码1获取全部音频文件代码private Cursor query(Uri uri, String prjs, String selections, String selectArgs, String order)ContentResolver resolver = pApp.getContentResolver();/取得papp的一个resolver实例if (resolver = null)return null;return resolver.query(uri, prjs, selections, selectArgs, order);public Cursor getAllSongs() /取得所有音频文件return query(MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, null, null, null, MediaStore.Audio.Media.DEFAULT_SORT_ORDER);2绑定歌曲列表到listview控件public void bindView(View view, Context context, Cursor cursor) super.bindView(view, context, cursor);TextView titleView = (TextView) view.findViewById(android.R.id.text1);TextView artistView = (TextView) view.findViewById(android.R.id.text2);titleView.setText(cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.Audio.Media.TITLE);/绑定歌曲名artistView.setText(cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.Audio.Media.ARTIST);/绑定演唱者3软件初始化 setContentView(R.layout.list_layout); MusicPlayerApp musicPlayerApp=(MusicPlayerApp)getApplication();/取得一个实例 mMusicInfoController = (musicPlayerApp).getMusicInfoController(); startService(new Intent(this,MusicPlayerService.class); /启动服务 bindService(new Intent(this,MusicPlayerService.class), mPlaybackConnection, Context.BIND_AUTO_CREATE);/绑定服务 mTextView = (TextView)findViewById(R.id.show_text);/取得显示文本控件 mPlayPauseButton = (Button) findViewById(R.id.play_pause_btn);/取得开始和暂停控件 mStopButton = (Button) findViewById(R.id.stop_btn);/取得停止控件 mPlayPauseButton.setOnClickListener(new Button.OnClickListener() /播放和暂停按钮的事件绑定 public void onClick(View v) if (mMusicPlayerService != null & mMusicPlayerService.isPlaying() mMusicPlayerService.pause();/暂停播放 mPlayPauseButton.setText(R.string.play);/改变控件文字 else if (mMusicPlayerService != null) mMusicPlayerService.start();/服务没启动则启动 mPlayPauseButton.setText(R.string.pause);/改变控件文字为暂停 ); mStopButton.setOnClickListener(new Button.OnClickListener() /停止按钮的事件绑定 public void onClick(View v) if (mMusicPlayerService != null ) mTextView.setVisibility(View.VISIBLE); mPlayPauseButton.setVisibility(View.INVISIBLE);/改变播放按钮为不可见 mStopButton.setVisibility(View.INVISIBLE); mMusicPlayerService.stop();/停止播放 ); IntentFilter filter = new IntentFilter(); filter.addAction(MusicPlayerService.PLAYER_PREPARE_END);/ filter.addAction(MusicPlayerService.PLAY_COMPLETED); registerReceiver(mPlayerEvtReceiver, filter);/放入后台4.音乐播放服务MediaPlayer.OnCompletionListener mCompleteListener = new MediaPlayer.OnCompletionListener() /实例化化一个listener匿名类 public void onCompletion(MediaPlayer mp) /完成绑定时调用 broadcastEvent(PLAY_COMPLETED);/广播消息 ; MediaPlayer.OnPreparedListener mPrepareListener = new MediaPlayer.OnPreparedListener() /绑定钱调用 public void onPrepared(MediaPlayer mp) broadcastEvent(PLAYER_PREPARE_END);/广播事件 ; private void broadcastEvent(String what)Intent i = new Intent(what);sendBroadcast(i);/广播消息public void onCreate()super.onCreate();mMediaPlayer = new MediaPlayer();/实例化一个播放类mMediaPlayer.setOnPrepared