MediaPlayer类可用于控制音频/视频文件或流的播放。关于如何使用这个类的方法还可以阅读VideoView类的文档。
1.状态图
对播放音频/视频文件和流的控制是通过一个状态机来管理的。下图显示一个MediaPlayer对象被支持的播放控制操作驱动的生命周期和状态。椭圆代表MediaPlayer对象可能驻留的状态。弧线表示驱动MediaPlayer在各个状态之间迁移的播放控制操作。这里有两种类型的弧线。由一个箭头开始的弧代表同步的方法调用,而以双箭头开头的代表的弧线代表异步方法调用。
通过这张图,我们可以知道一个MediaPlayer对象有以下的状态:
1)当一个MediaPlayer对象被刚刚用new操作符创建或是调用了reset()方法后,它就处于Idle状态。当调用了release()方法后,它就处于End状态。这两种状态之间是MediaPlayer对象的生命周期。
1.1) 在一个新构建的MediaPlayer对象和一个调用了reset()方法的MediaPlayer对象之间有一个微小的但是十分重要的差别。在处于Idle状态时,调用getCurrentPosition(), getDuration(), getVideoHeight(), getVideoWidth(), setAudioStreamType(int), setLooping(boolean), setVolume(float, float), pause(), start(), stop(), seekTo(int), prepare() 或者 prepareAsync() 方法都是编程错误。当一个MediaPlayer对象刚被构建的时候,内部的播放引擎和对象的状态都没有改变,在这个时候调用以上的那些方法,框架将无法回调客户端程序注册的OnErrorListener.onError()方法;但若这个MediaPlayer对象调用了reset()方法之后,再调用以上的那些方法,内部的播放引擎就会回调客户端程序注册的OnErrorListener.onError()方法了,并将错误的状态传入。
1.2) 我们建议,一旦一个MediaPlayer对象不再被使用,应立即调用release()方法来释放在内部的播放引擎中与这个MediaPlayer对象关联的资源。资源可能包括如硬件加速组件的单态组件,若没有调用release()方法可能会导致之后的MediaPlayer对象实例无法使用这种单态硬件资源,从而退回到软件实现或运行失败。一旦MediaPlayer对象进入了End状态,它不能再被使用,也没有办法再迁移到其它状态。
1.3) 此外,使用new操作符创建的MediaPlayer对象处于Idle状态,而那些通过重载的create()便利方法创建的MediaPlayer对象却不是处于Idle状态。事实上,如果成功调用了重载的create()方法,那么这些对象已经是Prepare状态了。
2) 在一般情况下,由于种种原因一些播放控制操作可能会失败,如不支持的音频/视频格式,缺少隔行扫描的音频/视频,分辨率太高,流超时等原因,等等。因此,错误报告和恢复在这种情况下是非常重要的。有时,由于编程错误,在处于无效状态的情况下调用了一个播放控制操作可能发生。在所有这些错误条件下,内部的播放引擎会调用一个由客户端程序员提供的OnErrorListener.onError()方法。客户端程序员可以通过调用MediaPlayer.setOnErrorListener(android.media.MediaPlayer.OnErrorListener)方法来注册OnErrorListener.
2.1) 一旦发生错误,MediaPlayer对象会进入到Error状态。
2.2) 为了重用一个处于Error状态的MediaPlayer对象,可以调用reset()方法来把这个对象恢复成Idle状态。
2.3) 注册一个OnErrorListener来获知内部播放引擎发生的错误是好的编程习惯。
2.4) 在不合法的状态下调用一些方法,如prepare(),prepareAsync()和setDataSource()方法会抛出IllegalStateException异常。
3) 调用setDataSource(FileDescriptor)方法,或setDataSource(String)方法,或setDataSource(Context,Uri)方法,或setDataSource(FileDescriptor,long,long)方法会使处于Idle状态的对象迁移到Initialized状态。
3.1) 若当此MediaPlayer处于其它的状态下,调用setDataSource()方法,会抛出IllegalStateException异常。
3.2) 好的编程习惯是不要疏忽了调用setDataSource()方法的时候可能会抛出的IllegalArgumentException异常和IOException异常。
4) 在开始播放之前,MediaPlayer对象必须要进入Prepared状态。
4.1) 有两种方法(同步和异步)可以使MediaPlayer对象进入Prepared状态:要么调用prepare()方法(同步),此方法返回就表示该MediaPlayer对象已经进入了Prepared状态;要么调用prepareAsync()方法(异步),此方法会使此MediaPlayer对象进入Preparing状态并返回,而内部的播放引擎会继续未完成的准备工作。当同步版本返回时或异步版本的准备工作完全完成时就会调用客户端程序员提供的OnPreparedListener.onPrepared()监听方法。可以调用MediaPlayer.setOnPreparedListener(android.media.MediaPlayer.OnPreparedListener)方法来注册OnPreparedListener.
4.2) Preparing是一个中间状态,在此状态下调用任何具备边影响的方法的结果都是未知的!
4.3) 在不合适的状态下调用prepare()和prepareAsync()方法会抛出IllegalStateException异常。当MediaPlayer对象处于Prepared状态的时候,可以调整音频/视频的属性,如音量,播放时是否一直亮屏,循环播放等。
5) 要开始播放,必须调用start()方法。当此方法成功返回时,MediaPlayer的对象处于Started状态。isPlaying()方法可以被调用来测试某个MediaPlayer对象是否在Started状态。
5.1) 当处于Started状态时,内部播放引擎会调用客户端程序员提供的OnBufferingUpdateListener.onBufferingUpdate()回调方法,此回调方法允许应用程序追踪流播放的缓冲的状态。
5.2) 对一个已经处于Started 状态的MediaPlayer对象调用start()方法没有影响。
6) 播放可以被暂停,停止,以及调整当前播放位置。当调用pause()方法并返回时,会使MediaPlayer对象进入Paused状态。注意Started与Paused状态的相互转换在内部的播放引擎中是异步的。所以可能需要一点时间在isPlaying()方法中更新状态,若在播放流内容,这段时间可能会有几秒钟。
6.1) 调用start()方法会让一个处于Paused状态的MediaPlayer对象从之前暂停的地方恢复播放。当调用start()方法返回的时候,MediaPlayer对象的状态会又变成Started状态。
6.2) 对一个已经处于Paused状态的MediaPlayer对象pause()方法没有影响。
7) 调用stop()方法会停止播放,并且还会让一个处于Started,Paused,Prepared或PlaybackCompleted状态的MediaPlayer进入Stopped状态。
7.1) 对一个已经处于Stopped状态的MediaPlayer对象stop()方法没有影响。
8) 调用seekTo()方法可以调整播放的位置。
8.1) seekTo(int)方法是异步执行的,所以它可以马上返回,但是实际的定位播放操作可能需要一段时间才能完成,尤其是播放流形式的音频/视频。当实际的定位播放操作完成之后,内部的播放引擎会调用客户端程序员提供的OnSeekComplete.onSeekComplete()回调方法。可以通过setOnSeekCompleteListener(OnSeekCompleteListener)方法注册。
8.2) 注意,seekTo(int)方法也可以在其它状态下调用,比如Prepared,Paused和PlaybackCompleted状态。此外,目前的播放位置,实际可以调用getCurrentPosition()方法得到,它可以帮助如音乐播放器的应用程序不断更新播放进度
9) 当播放到流的末尾,播放就完成了。
9.1) 如果调用了setLooping(boolean)方法开启了循环模式,那么这个MediaPlayer对象会重新进入Started状态。
9.2) 若没有开启循环模式,那么内部的播放引擎会调用客户端程序员提供的OnCompletion.onCompletion()回调方法。可以通过调用MediaPlayer.setOnCompletionListener(OnCompletionListener)方法来设置。内部的播放引擎一旦调用了OnCompletion.onCompletion()回调方法,说明这个MediaPlayer对象进入了PlaybackCompleted状态。
9.3) 当处于PlaybackCompleted状态的时候,可以再调用start()方法来让这个MediaPlayer对象再进入Started状态。
分享到:
相关推荐
Android API文档是开发者在进行Android应用开发时的重要参考资料,它详尽地介绍了Android系统的各种接口、类库和功能。这份“Android API文档完整版”包含了官方文档和具有搜索功能的版本,使得开发者能够更高效地...
API文档通常包括以下部分: 1. **框架API**:这部分主要介绍Android系统的各种组件,如Activity(活动)、Service(服务)、Broadcast Receiver(广播接收器)、Content Provider(内容提供者),以及Intent(意图...
"Android中文API文档(系列汇总)"是一个集合了Android各个组件API的中文参考资料,旨在为开发者提供便捷的查询途径,帮助他们在编程过程中快速找到所需的信息。这篇文档详尽地涵盖了Android系统的各个方面,包括但不...
SDK(软件开发工具包)包含API文档、模拟器、工具和示例代码,用于开发和测试应用。 三、关键API模块 1. UI框架:包括View系统、Layout管理器以及事件处理机制,如OnClickListener和Adapter。 2. 数据存储:SQLite...
Android API中文帮助文档合集是为Android开发者提供的一份详尽的参考资料,旨在助力开发者更好地理解和使用Android平台的各种功能和接口。这份文档包含了从基础到高级的各类Android开发知识点,覆盖了系统架构、UI...
Android API官方文档是Android开发者的重要...以上只是Android API文档中的冰山一角,文档还包含了详细的API参考、示例代码、最佳实践以及开发者指南等内容,是开发者解决问题、学习新技术和提升开发技能的强大资源。
《安卓开发API文档-中文版》是一份针对安卓应用程序开发者的详尽参考资料,它涵盖了从基础到高级的各种API和开发技巧。这份文档是中文版本,方便国内开发者阅读和理解,消除了语言障碍,使得学习和使用安卓开发变得...
通过阅读和研究Android API文档,开发者不仅可以了解Android平台的详细信息,还能学习到最佳实践,从而更好地利用这些API来构建高效、稳定和用户体验优秀的Android应用。这份文档不仅适合初学者入门,也是经验丰富的...
Android中文API文档大全是开发者们不可或缺的资源,它包含了Android平台的所有主要组件、服务、接口以及工具的详细说明。这份文档旨在帮助中国开发者更轻松地理解和应用Android系统,避免语言障碍,提高开发效率。 ...
Android API中文文档是针对开发者的一款极其重要的资源,它详尽地介绍了Android操作系统中各种API接口、类库和功能。这份文档对于任何想要在Android平台上进行应用开发的人来说都是必不可少的工具。下面将对其中的...
《Android API文档全面解析》 Android API文档是每一位Android开发者不可或缺的参考资料,它详尽地阐述了Android系统各个版本的API接口、类库以及开发工具的使用方法。这份CHM格式的文档包含了从基础概念到高级特性...
《Android官方API文档完整版》是由away1vy分享的一份宝贵资源,对于深入理解并熟练掌握Android开发至关重要。这份文档全面覆盖了Android系统的各个层面,包括核心库、UI框架、网络通信、数据存储、多媒体处理等多个...
《Android中文API文档》是Android开发者的重要参考资料,它详尽地介绍了Android系统提供的各种API接口、类库和服务,为开发者提供了全面的开发指南。这份文档包括了chm和pdf两种格式,方便在不同环境下查阅。 ...
在Android开发领域,掌握官方API文档是至关重要的,因为它提供了详细的API接口、类库以及方法说明,帮助开发者深入理解Android系统的运作机制和编程模型。虽然大部分Android开发者习惯于查阅英文版的官方文档,但...
Android API文档是Android开发者不可或缺的参考资料,它详细阐述了Android操作系统各版本的API接口、类库、方法以及各种工具的使用。这份文档包含了中文版和英文官方版,为不同语言背景的开发者提供了便利,能够更好...
Android API文档是Android开发者不可或缺的参考资料,它详细阐述了Android系统的各种组件、接口、类库以及函数等。这个完整版的文档包含了从Android系统最早版本到最新版本的所有API信息,对于深入理解和开发Android...
Android API文档还涵盖了XML布局文件的使用,包括各种视图(View)和视图组(ViewGroup)的创建和定制。开发者可以学习如何使用TextView、Button、ImageView等基本控件,以及如何使用LinearLayout、RelativeLayout...
Android官方API离线版是一个非常宝贵的资源,它包含了大量的Android开发所需的信息,使得开发者无需互联网连接也能查阅Android的API文档。这个压缩包提供的是`.chm`格式的文件,这是一种由微软开发的帮助文件格式,...
Android API中文帮助文档合集是Android开发者不可或缺的资源,它涵盖了Android系统开发的各个方面,从基础概念到高级特性,为开发者提供了详尽的指导和参考资料。这个文档集合旨在帮助开发者理解并有效地使用Android...