Android开发之MdiaPlayer详解

简介:

Android开发之MdiaPlayer详解

 

MediaPlayer类可用于控制音频/视频文件或流的播放,我曾在《Android开发之基于Service的音乐播放器》一文中介绍过它的使用。下面让我们看一下MediaPlayer类的详细介绍。

一、类结构:

java.lang.Object

   ?

android.media.MediaPlayer

 

二、构造方法和公有方法

构造方法:

Public Constructors

 

MediaPlayer()

默认构造方法。

 

公有方法:

Public Methods

static MediaPlayer

create(Context context, Uri uri, SurfaceHolder holder)

指定从资源ID对应的资源文件中来装载音乐文件,同时指定了SurfaceHolder对象并返回MediaPlyaer对象。

static MediaPlayer

create(Context context, int resid)

指定从资源ID对应的资源文件中来装载音乐文件,并返回新创建的MediaPlyaer对象。

static MediaPlayer

create(Context context, Uri uri)

从指定Uri装在音频文件,并返回新创建的MediaPlayer对象。

int

getCurrentPosition()

获取当前播放的位置。

int

getDuration()

获取音频的时长。

int

getVideoHeight()

获取视频的高度。

int

getVideoWidth()

获取视频的宽度。

boolean

isLooping()

判断MediaPlayer是否正在循环播放。

boolean

isPlaying()

判断MediaPlayer是否正在播放。

void

pause()

暂停播放。

void

prepare()

准备播放(装载音频),调用此方法会使MediaPlayer进入Prepared状态。

void

prepareAsync()

准备播放异步音频。

void

release()

释放媒体资源。

void

reset()

重置MediaPlayer进入未初始化状态。

void

seekTo(int msec)

寻找指定的时间位置。

void

setAudioStreamType(int streamtype)

设置音频流的类型。

void

setDataSource(String path)

指定装载path路径所代表的文件。

void

setDataSource(Context context, Uri uri, Map<String, String headers)

指定装载uri所代表的文件。

void

setDataSource(Context context, Uri uri)

指定装载uri所代表的文件。

void

setDataSource(FileDescriptor fd, long offset, long length)

指定装载fd所代表的文件中从offset开始长度为length的文件内容。

void

setDataSource(FileDescriptor fd)

指定装载fd所代表的文件。

void

setDisplay(SurfaceHolder sh)

设置显示方式。

void

setLooping(boolean looping)

设置是否循环播放。

void

setNextMediaPlayer(MediaPlayer next)

设置当前流媒体播放完毕,下一个播放的MediaPlayer。

void

setOnBufferingUpdateListener(MediaPlayer.OnBufferingUpdateListener listener)

注册一个回调函数,在网络视频流缓冲变化时调用。

void

setOnCompletionListener(MediaPlayer.OnCompletionListener listener)

为Media Player的播放完成事件绑定事件监听器。

void

setOnErrorListener(MediaPlayer.OnErrorListener listener)

为MediaPlayer的播放错误事件绑定事件监听器。

void

setOnPreparedListener(MediaPlayer.OnPreparedListener listener)

当MediaPlayer调用prepare()方法时触发该监听器。

void

setOnSeekCompleteListener(MediaPlayer.OnSeekCompleteListener listener)

当MediaPlayer调用seek()方法时触发该监听器。

void

setOnVideoSizeChangedListener(MediaPlayer.OnVideoSizeChangedListener listener)

注册一个用于监听视频大小改变的监听器。

void

setScreenOnWhilePlaying(boolean screenOn)

置是否使用SurfaceHolder来显示。

void

setSurface(Surface surface)

设置Surface。

void

setVideoScalingMode(int mode)

设置视频缩放的模式。

void

setVolume(float leftVolume, float rightVolume)

设置播放器的音量。

void

setWakeMode(Context context, int mode)

为MediaPlayer设置低级电源管理行为。.

void

start()

开始或恢复播放。

void

stop()

停止播放。

 

三、常用方法分析:

1.使用进度条:

进度条SeekBar可以用来显示播放进度,用户也可以利用SeekBar的滑块来控制音乐的播放。

SeekBar需要使用的一些方法:

setProgress(int value):设置滑块的位置方法为。

setMax(int value):设置进度条的最大长度。

setOnSeekBarChangeListener(OnSeekBarChangeListener l):设置SeekBar的进度改变事件。

MusicPlayer需要使用的一些方法:

getDuration():获得音乐长度为。

getCurrentPosition():获得现在播放的位置。

seekTo(int msec):调用seekTo()方法可以调整播放的位置。

seekTo(int)方法是异步执行的,所以它可以马上返回,但是实际的定位播放操作可能需要一段时间才能完成,尤其是播放流形式的音频/视频。当实际的定位播放操作完成之后,内部的播放引擎会调用客户端程序员提供的OnSeekComplete.onSeekComplete()回调方法。可以通过setOnSeekCompleteListener(OnSeekCompleteListener)方法注册。

seekTo(int)方法也可以在其它状态下调用,比如Prepared,Paused和PlaybackCompleted状态。此外,目前的播放位置,实际可以调用getCurrentPosition()方法得到,它可以帮助如音乐播放器的应用程序不断更新播放进度。

创建并使用进度条的步骤:

第一步:创建一个进度条

//进度条

static SeekBarskbMusic;

skbMusic=(SeekBar)findViewById(R.id.skbMusic);

 

第二步:为进度条的改变事件注册并添加监听器

skbMusic.setOnSeekBarChangeListener(sChangeListener);

/**

  * SeekBar进度改变事件

  */

OnSeekBarChangeListenersChangeListener=new OnSeekBarChangeListener() {                 

        @Override

        public void onStopTrackingTouch(SeekBar seekBar) {

                  // TODO Auto-generated method stub

                  //当拖动停止后,控制mediaPlayer播放指定位置的音乐

                  MusicService.mediaPlayer.seekTo(seekBar.getProgress());

       MusicService.isChanging=false;  

        }       

        @Override

        public void onStartTrackingTouch(SeekBar seekBar) {

                  // TODO Auto-generated method stub

                  MusicService.isChanging=true;

        }       

        @Override

        public void onProgressChanged(SeekBar seekBar, int progress,

                           boolean fromUser) {

                  // TODO Auto-generated method stub           

        }

};

 

第三步:设置进度条的最大长度:

//getDuration()方法要在prepare()方法之后,否则会出现Attempt to call getDuration without a valid mediaplayer异常

MusicBox.skbMusic.setMax(mediaPlayer.getDuration());//设置SeekBar的长度

 

第四步:更新进度条

//----------定时器记录播放进度---------//

mTimer =new Timer();

mTimerTask =new TimerTask() {

    @Override

    publicvoid run() {

        isTimerRunning=true;

        if(isChanging==true)//当用户正在拖动进度进度条时不处理进度条的的进度

           return

        MusicBox.skbMusic.setProgress(mediaPlayer.getCurrentPosition());

    }

};

//每隔10毫秒检测一下播放进度

mTimer.schedule(mTimerTask, 0, 10);

 

2.装载音频文件:

为了让MediaPlayer来装载指定音频文件,MediaPlayer提供了如下简单的静态方法。

static MediaPlayer create(Context context, Uri uri):从指定Uri来装载音频文件,并返回新创建的MediaPlayer对象。

static MediaPlayer create(Context context, int resid):从 resid资源 ID对应的资源文件中装载音频文件,并返回新创建的MediaPlayer对象。

提示:上而这两个方法用起来非常方便,但这两个方法每次都会返回新创建的MediaPlayer对象,如来程序需要使用MediaPlayer循环播放多个音频文件,使用MediaPlayer的静态create方法就不太合适了,此时可通过MediaPlayer的setDataSource()方法来装载指定的音频文件。MediaPlayer提供了如下方法来指定装载相应的音频文件。

setDataSource(String path):指定装载path路径所代表的文件。

setDataSource(FileDescriptor fd, long offset,long length):指定装载fd所代表的文件中从offset开始长度为length的文件内容。

setDataSource(FileDescriptor fd):指定装载fd所代表的文件。

setDataSource(Context context, Uri uri):指定装载uri所代表的文件。

提示:执行上面所示的setDataSource()方法之后,MediaPlayer并未真正去装载那些音频文件,还需要调用MediaPlayer的prepare()方法去准备音频,所谓“准备”,就是让MediaPlayer真正去装载音频文件。

使用已有的MediaPlayer对象装载“一首”歌曲的代码模板为:

mPlayer.reset();

//装战下一竹歌曲

mPlayer.setDataSource(M/mnt/sdcard/next.mp3);

//准备声音 mPlayer.prepare();

"播放

mPlayer.start();

}

catch (IOException e)

e.printStackTrace();

}

 

3.与MediaPlayer有关的事件监听器:

MediaPlayer提供了一些绑定事件监听器的方法,用于监听MediaPlayer播放过程中所发生的特定事件,绑定事件监听器的方法如下。

setOnCompletionListener(MediaPlayer.OnCompletionListener listener):为 Media Player的播放完成事件绑定事件监听器。

setOnErrorListener(MediaPlayer.OnErrorListener listener):为MediaPlayer的播放错误事件绑定事件监听器。

setOnPreparedListener(MediaPlayer.OnPreparedListener listener):当 MediaPlayer调用prepare()方法时触发该监听器。

setOnSeekCompleteListener(MediaPlayer.OnSeekCompleteListener listener):当MediaPlayer调用seek()方法时触发该监听器。

因此可以在创建一个MediaPlayer对象之后,通过为该MediaPlayer绑定监听器来监听相应的事件,例如如下代码:

//为MediaPlayer的播放完成事件绑定事件监听器

mPlayer.setOnErrorListener(new OnErrorListener() {         

    @Override

    publicboolean onError(MediaPlayer mp,int what,int extra) {       

        // TODO Auto-generated method stub

        //针对错误进行相应的处理

//             ... ...

    }

});

//为MediaPlayer的播放完成讲件绑定市件监听器

mPlayer.setOnCompletionListener(new OnCompletionListener() {           

    @Override

    publicvoid onCompletion(MediaPlayer mp) {

        // TODO Auto-generated method stub

           current++;

           prepareAndPlay(current);   

        }

   });

 

四、MediaPlayer播放不同来源的音频文件:

1.播放应用的资源文件

播放应用的资源文件需要两步即:

1) 调用MediaPlayer的create(Context context,int resid)方法加指定资源文件。

2) 调用 MediaPlayer的 start()、pause()、stop()等方法控制播放即可。

例如如下代码:

MediaPlayer mPlayer=new MediaPlayer();

mPlayer.create(this, R.raw.music);

 

2.  播放应用的原始资源文件

播放应用的资源文件按如下步骤执行。

1) 调用 Context的 getAssets()方法获取应用的 AssetManager。

2) 调用AssetManager对象的openFd(String name)方法打开指定的原生资源,该方法返回一个AssetFileDescriptor对象。

3) 调用 AssetFileDescriptor的 getFileDescriptor()、getStartOffset()和 getLength()方法来获取音频文件的FileDescriptor、开始位置、长度等。

4) 创建MediaPlayer对象(或利用已有的MediaPlayer对象),并调用MediaPlayer对象的setDataSource(FileDescriptor fd,long offset, long length)方法来装载音频资源。

5) 调用MediaPlayer对象的prepare()方法准备音频。

6) 调用MediaPlayer的start()、pause()、stop()等方法控制播放即可。

例如如下代码片段:

//获取assets目录下指定文件的AssetFileDescriptor对象

AssetFileDescriptor assetFileDescriptor=assetManager.openFd(musics[current]);

mediaPlayer.reset();//初始化mediaPlayer对象

mediaPlayer.setDataSource(assetFileDescriptor.getFileDescriptor(),     assetFileDescriptor.getStartOffset(), assetFileDescriptor.getLength());

//准备播放音乐

mediaPlayer.prepare();

//播放音乐

mediaPlayer.start();

3.  播放外部存储器上音频文件

播放外部存储器上音频文件按如下步骤执行。

1) 创建MediaPlayer对象(或利用已有的MediaPlayer对象),并调用MediaPlayer对象的setDateSource(String path)方法装载指定的音频文件。  

2) 调用MediaPlayer对象的prepare()方法准备音频。    

3) 调用MediaPlayer的start()、pause()、stop()等方法控制播放即可。

例如如下代码:

//加载SD卡上的指定资源音频文件

mPlayer.setDataSource("/mnt/You Are The One.mp3");

mPlayer.prepare();//准备因音频

mPlayer.start();//播放音频

4.播放来自网络的音频文件

播放来自网络的音频文件?两种方式:1.直接使用MediaPlayer的静态create(Context context, Uri uri)方法;2.调用 MediaPlayer的setDataSource(Context context,Uri uri)装载指定Uri对应的音频文件。

以第二种方式播放来自网络的音频文件的步骤如下。

1. 根据网络上的音频文件所在的位置创建Uri对象。

2. 创建MediaPlayer对象(或利用己有的MediaPlayer对象),并调用MediaPlayer对象的 setDateSource(Context context,Uri uri)方法装载Uri对应的音频文件。

3. 调用MediaPlayer对象的prepare()方法准备音频。

4. 调用MediaPlayer的start()、pause()、stop()等方法控制播放即可。

例如如下代码片段:

Uri uri = Uri.parse("http://play.baidu.com/heihei.mp3");

MediaPlayer mPlayer = new MediaPlayer();

//使用MediaPlayer根据Uri来加载指定的声音文件

mPlayer.setDataSource(this, uri);

mPlayer.prepare();//准备因音频

mPlayer.start();//播放音频

MediaPlayer除了调用prepare()方法来准备声音之外,还以调用prepareAsync()来准备声音,prepareAsync()与普通prepare()方法的区别在于,prepareAsync()是异步的,它不会阻塞当前的UI线程。

五、解析MdiaPlayer的状态图

mediaplayer状态图

上面这张状态转换图清晰的描述了MediaPlayer的各个状态,也列举了主要的方法的调用时序,每种方法只能在一些特定的状态下使用,如果使用时MediaPlayer的状态不正确则会引发IllegalStateException异常。

Idle状态:当使用new()方法创建一个MediaPlayer对象或者调用了其reset()方法时,该MediaPlayer对象处于idle状态。在处于Idle状态时,调用getCurrentPosition(), getDuration(), getVideoHeight(),getVideoWidth(),setAudioStreamType(int), setLooping(boolean), setVolume(float, float), pause(), start(), stop(), seekTo(int), prepare()或者 prepareAsync()方法都会出现相应错误。这两种方法的一个重要差别就是:当一个MediaPlayer对象刚被构建的时候,内部的播放引擎和对象的状态都没有改变,在这个时候调用以上的那些方法,框架将无法回调客户端程序注册的OnErrorListener.onError()方法,所以不会进入Error状态;但若这个MediaPlayer对象调用了reset()方法之后,再调用以上的那些方法,内部的播放引擎就会回调客户端程序注册的OnErrorListener.onError()方法,这时MediaPlayer会进入Error状态。

提示:使用new操作符创建的MediaPlayer对象处于Idle状态,而那些通过重载的create()便利方法创建的MediaPlayer对象却不是处于Idle状态。事实上,如果成功调用了重载的create()方法,那么这些对象已经是Prepare状态了。

 

End状态:通过release()方法可以进入End状态,只要MediaPlayer对象不再被使用,就应当尽快将其通过release()方法释放掉,以释放相关的软硬件组件资源,这其中有些资源是只有一份的(相当于临界资源)。如果MediaPlayer对象进入了End状态,则不会再进入任何其他状态了。

 

Initialized状态:这个状态比较简单,MediaPlayer调用setDataSource()方法就进入Initialized状态,表示此时要播放的文件已经设置好了。

提示:若当此MediaPlayer处于其它的状态下,调用setDataSource()方法,会抛出IllegalStateException异常。

 

Prepared状态:初始化完成之后还需要通过调用prepare()或prepareAsync()方法,这两个方法一个是同步的一个是异步的,只有进入Prepared状态,才表明MediaPlayer到目前为止都没有错误,可以进行文件播放。

提示:在不合适的状态下调用prepare()和prepareAsync()方法会抛出IllegalStateException异常。当MediaPlayer对象处于Prepared状态的时候,可以调整音频/视频的属性,如音量,播放时是否一直亮屏,循环播放等。

 

Preparing状态:这个状态比较好理解,主要是和prepareAsync()配合,如果异步准备完成,会触发OnPreparedListener.onPrepared(),进而进入Prepared状态。

 

Started状态:显然,MediaPlayer一旦准备好,就可以调用start()方法,这样MediaPlayer就处于Started状态,这表明MediaPlayer正在播放文件过程中。可以使用isPlaying()测试MediaPlayer是否处于了Started状态。如果播放完毕,而又设置了循环播放,则MediaPlayer仍然会处于Started状态,类似的,如果在该状态下MediaPlayer调用了seekTo()或者start()方法均可以让MediaPlayer停留在Started状态。

 

Paused状态:Started状态下MediaPlayer调用pause()方法可以暂停MediaPlayer,从而进入Paused状态,MediaPlayer暂停后再次调用start()则可以继续MediaPlayer的播放,转到Started状态,暂停状态时可以调用seekTo()方法,这是不会改变状态的。

 

Stop状态:Started或者Paused状态下均可调用stop()停止MediaPlayer,而处于Stop状态的MediaPlayer要想重新播放,需要通过prepareAsync()和prepare()回到先前的Prepared状态重新开始才可以。

 

PlaybackCompleted状态:文件正常播放完毕,而又没有设置循环播放的话就进入该状态,并会触发OnCompletionListener的onCompletion()方法。此时可以调用start()方法重新从头播放文件,也可以stop()停止MediaPlayer,或者也可以seekTo()来重新定位播放位置。

 

Error状态:在一般情况下,由于种种原因一些播放控制操作可能会失败,如不支持的音频/视频格式,缺少隔行扫描的音频/视频,分辨率太高,流超时等原因,等等会触发会触发OnErrorListener.onError()事件,此时MediaPlayer会进入Error状态,及时捕捉并妥善处理这些错误是很重要的,可以帮助我们及时释放相关的软硬件资源,也可以改善用户体验。

开发者可以通过setOnErrorListener(android.media.MediaPlayer.OnErrorListener设置监听器来监听MediaPlayer是否进入Error状态。如果MediaPlayer进入了Error状态,可以通过调用reset()来恢复,使得MediaPlayer重新返回到Idle状态。


    本文转自 一点点征服   博客园博客,原文链接:http://www.cnblogs.com/ldq2016/p/5365080.html,如需转载请自行联系原作者





相关文章
|
1月前
|
开发框架 前端开发 Android开发
安卓与iOS开发中的跨平台策略
在移动应用开发的战场上,安卓和iOS两大阵营各据一方。随着技术的演进,跨平台开发框架成为开发者的新宠,旨在实现一次编码、多平台部署的梦想。本文将探讨跨平台开发的优势与挑战,并分享实用的开发技巧,帮助开发者在安卓和iOS的世界中游刃有余。
|
1月前
|
缓存 前端开发 Android开发
安卓开发中的自定义视图:从零到英雄
【10月更文挑战第42天】 在安卓的世界里,自定义视图是一块画布,让开发者能够绘制出独一无二的界面体验。本文将带你走进自定义视图的大门,通过深入浅出的方式,让你从零基础到能够独立设计并实现复杂的自定义组件。我们将探索自定义视图的核心概念、实现步骤,以及如何优化你的视图以提高性能和兼容性。准备好了吗?让我们开始这段创造性的旅程吧!
27 1
|
1月前
|
搜索推荐 Android开发 开发者
探索安卓开发中的自定义视图:打造个性化UI组件
【10月更文挑战第39天】在安卓开发的世界中,自定义视图是实现独特界面设计的关键。本文将引导你理解自定义视图的概念、创建流程,以及如何通过它们增强应用的用户体验。我们将从基础出发,逐步深入,最终让你能够自信地设计和实现专属的UI组件。
|
21天前
|
搜索推荐 前端开发 API
探索安卓开发中的自定义视图:打造个性化用户界面
在安卓应用开发的广阔天地中,自定义视图是一块神奇的画布,让开发者能够突破标准控件的限制,绘制出独一无二的用户界面。本文将带你走进自定义视图的世界,从基础概念到实战技巧,逐步揭示如何在安卓平台上创建和运用自定义视图来提升用户体验。无论你是初学者还是有一定经验的开发者,这篇文章都将为你打开新的视野,让你的应用在众多同质化产品中脱颖而出。
42 19
|
1月前
|
IDE Java 开发工具
移动应用与系统:探索Android开发之旅
在这篇文章中,我们将深入探讨Android开发的各个方面,从基础知识到高级技术。我们将通过代码示例和案例分析,帮助读者更好地理解和掌握Android开发。无论你是初学者还是有经验的开发者,这篇文章都将为你提供有价值的信息和技巧。让我们一起开启Android开发的旅程吧!
|
21天前
|
JSON Java API
探索安卓开发:打造你的首个天气应用
在这篇技术指南中,我们将一起潜入安卓开发的海洋,学习如何从零开始构建一个简单的天气应用。通过这个实践项目,你将掌握安卓开发的核心概念、界面设计、网络编程以及数据解析等技能。无论你是初学者还是有一定基础的开发者,这篇文章都将为你提供一个清晰的路线图和实用的代码示例,帮助你在安卓开发的道路上迈出坚实的一步。让我们一起开始这段旅程,打造属于你自己的第一个安卓应用吧!
46 14
|
24天前
|
Java Linux 数据库
探索安卓开发:打造你的第一款应用
在数字时代的浪潮中,每个人都有机会成为创意的实现者。本文将带你走进安卓开发的奇妙世界,通过浅显易懂的语言和实际代码示例,引导你从零开始构建自己的第一款安卓应用。无论你是编程新手还是希望拓展技术的开发者,这篇文章都将为你打开一扇门,让你的创意和技术一起飞扬。
|
22天前
|
XML 存储 Java
探索安卓开发之旅:从新手到专家
在数字时代,掌握安卓应用开发技能是进入IT行业的关键。本文将引导读者从零基础开始,逐步深入安卓开发的世界,通过实际案例和代码示例,展示如何构建自己的第一个安卓应用。我们将探讨基本概念、开发工具设置、用户界面设计、数据处理以及发布应用的全过程。无论你是编程新手还是有一定基础的开发者,这篇文章都将为你提供宝贵的知识和技能,帮助你在安卓开发的道路上迈出坚实的步伐。
31 5
|
20天前
|
开发框架 Android开发 iOS开发
安卓与iOS开发中的跨平台策略:一次编码,多平台部署
在移动应用开发的广阔天地中,安卓和iOS两大阵营各占一方。随着技术的发展,跨平台开发框架应运而生,它们承诺着“一次编码,到处运行”的便捷。本文将深入探讨跨平台开发的现状、挑战以及未来趋势,同时通过代码示例揭示跨平台工具的实际运用。
|
22天前
|
XML 搜索推荐 前端开发
安卓开发中的自定义视图:打造个性化UI组件
在安卓应用开发中,自定义视图是一种强大的工具,它允许开发者创造独一无二的用户界面元素,从而提升应用的外观和用户体验。本文将通过一个简单的自定义视图示例,引导你了解如何在安卓项目中实现自定义组件,并探讨其背后的技术原理。我们将从基础的View类讲起,逐步深入到绘图、事件处理以及性能优化等方面。无论你是初学者还是有经验的开发者,这篇文章都将为你提供有价值的见解和技巧。