【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析

作者 : 韩曙亮

转载请著名出处 :  http://blog.csdn.net/shulianghan/article/details/38487967

一. MediaPlayer 状态机 介绍

Android MediaPlayer 状态即图例 :

【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析

1. Idle (闲置) 状态 和 End (结束) 状态

【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析

MediaPlayer 对象声明周期 : 从 Idle 到 End 状态就是 MediaPlayer 整个生命周期;

-- 生命周期開始 : 进入 Idle (闲置) 状态;

-- 生命周期结束 : 进入 End (结束) 状态;

Idle 和 End 状态转换 :

-- 进入 Idle 状态 : MediaPlayer 刚被创建 new MediaPlayer() 或者 调用了 reset() 方法之后, 进入 Idle (闲置) 状态;

-- 进入 End 状态 : 在 Idle 状态调用 release() 方法后, 会进入 End (结束) 状态;

两种进入 Idle 状态方法的区别 : 在 Idle 状态无法调用 getCurrentPosition(), getDuration(), getVideoHeight(), getVideoWidth(), setAudioStreamtype(int), setLooping(boolean), setVolume(float, float), pause(), start(), stop(), seekTo(), prepare(), prepareAsync() 方法都是错误的;

-- new MediaPlayer() 进入 Idle 状态 : 此时 MediaPlayer 内部引擎 和 状态都没有改变, 调用上面的方法之后, 将 无法调用 OnErrorListener.onError() 方法;

-- reset() 进入 Idle 状态 :  此时假设调用上面的方法, 内部的引擎就会 回调 OnErrorListener.onError() 方法;

创建 和 重载 MediaPlayer 区别 :

-- 创建 MediaPlayer : 通过 new MediaPlayer() 创建的对象处于 Idle (闲置) 状态;

-- 重载 MediaPlayer : 通过 create() 方法创建的 MediaPlayer 对象处于 Prepare (准备) 状态;

End (结束) 状态解析 :

-- release() 方法作用 : 该方法会释放 播放引擎 中与 MediaPlayer 相关的资源;

-- 释放唯一性资源 : 有些资源如 硬件加速组件 单态组件等都是唯一性的资源, 假设不释放掉, 之后的 Mediaplayer 都无法正常执行;

-- 无法进行状态转换 : End 状态代表 MediaPlayer 生命周期结束, 在此状态不能转换成其他状态了;

2. Error (错误) 状态

【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析

Error 状态转换 : 当 MediaPlayer 出现一些错误如 格式错误, 分辨率过高等原因, 播放器引擎 就会调用 OnErrorListener.onError()方法;

-- 进入 Error 状态 : client调用 OnErrorListener.onError() 方法, 会进入 Error 状态;

-- 离开 Error 状态 : 假设想要使用进入 Error 状态的 MediaPlayer, 能够使用 reset() 方法进入 Idle 状态;

注冊监听 : 编程注冊一个 OnErrorListener 监听器, 用于获取 播放器引擎 内部发生的错误;

-- 注冊方法 : 调用 MediaPlayer.setOnErrorListener(OnErrorListener) 方法, 注冊 OnErrorListener;

关于一些异常抛出 : 在不合法的地方调用方法, 会抛出 IllegalStateException 异常;

3. Initalized (初始化) 状态

【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析

Initialized 状态转换 : 在 Idle 状态调用 setDataSource() 方法, MediaPlayer 会迁移到 Initialized 状态;

-- 注意 : 仅仅能是在 Idle 状态调用该方法, 假设在其他状态调用该方法, 会报出 IllegalStateException 异常;

4. Prepared (就绪) 和 Preparing (准备中) 状态

【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析

Prepared (就绪) 状态转换 :

-- 从 Initialized 状态迁移 : 在 Initialized 状态调用 prepare() 方法, 假设方法成功返回, MediaPlayer 就会进入 Prepared 状态;

-- 从 Preparing 状态迁移 : 在 Preparing 状态调用 OnPrepareListener.onPrepared() 方法迁移到 Prepared 状态;

Preparing (准备中) 状态 : Initialized 状态调用 prepareAsync() 方法进入 Preparing 状态;

-- 该状态执行的操作 : 在 Preparing 状态时, 播放器引擎会继续完成准备工作, 同步版本号返回 或者 异步版本号准备工作完成就会调用  OnPrepareListener.onPrepared() 方法进入 Prepared 状态;

抛出异常 : 仅仅有在 Initialized 方法中才干调用 prepare() 和 prepareAsync()方法, 在其他状态调用会报出 IllegalStateException 遗产;

Prepared 状态 MediaPlayer 可进行的操作 : 在这个状态 MediaPlayer 能够进行 音频视频属性 循环属性等操作;

5. Started (開始) 状态

【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析

Started 状态迁移 : 在 Prepared 状态调用 start() 方法, MediaPlayer 即迁移到了 Started 状态;

-- 推断 MediaPlayer 是否在 Started 状态 : 在不论什么状态下调用 isPlaying() 方法, 能够推断 MediaPlayer 是否在 Started 状态;

-- 跟踪缓冲状态 : 在 Started 状态, 调用 OnBufferingUpdateListener.onBufferingUpdate() 方法, 能够获取视频音频流的缓冲状态;

6. Paused (暂停) 状态

【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析

Paused (暂停) 状态迁移 : 在 Started 状态调用 pause() 方法, MediaPlayer 会进入 Paused 状态;

-- 状态迁移时间 : Started 状态转换为 Paused 状态须要一定时间, 这个过程是异步的, 过一段时间之后 isPlaying() 状态才会改变;

-- 回到 Started 状态 : 在 Paused 状态调用 start() 方法, 会进入 Started 状态;

7. Stopped (停止) 状态

【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析

Stopped 状态迁移 : 在 Prepared, Started, Paused, PlaybackCompleted 状态下 调用 stop() 方法, MediaPlayer 会迁移到 Stopped 状态;

8. 播放位置调整

【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析     【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析     【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析

seekTo() 方法说明 : 该方法异步, 调用后 播放器引擎还须要进行其他操作, 跳转才干完成;

-- 进行的操作 : 播放器引擎会回调 OnSeekComplete.onSeekComplete()方法, 该方法通过 setOnSeekCompleteListener() 方法注冊;

-- seekTo() 方法调用状态 : 该方法能够在 Prepared, Paused, PlaybackCompleted 状态进行调用;

-- 获取播放位置 : 调用 getCurrentPosition() 方法, 能够获取当前播放的位置, 能够帮助播放器更新进度条;

9. PlaybackCompleted (播放完成) 状态

【Android 多媒体开发】 MediaPlayer 状态机 接口 方法 解析

循环模式开启 : 假设之前使用了 setLooping() 开启了循环模式, 播放完成之后 MediaPlayer 会又一次进入 Started 状态;

PlaybackCompleted 状态迁移 : 假设没有设置循环模式, 那么播放完成之后会调用 OnCompletion.onCompletion() 回调方法, MediaPlayer 会进入 PlaybackCompleted 状态;

-- OnCompletion注冊 : 调用 MediaPlayer.setOnCompletionListener() 注冊该监听器;

-- 进入 Started 状态方法 : 在 PlaybackCompleted 状态时, 调用 satrt() 方法能够进入 Started 状态;

二. MediaPlayer 接口 和 常量

1. MediaPlayer 接口

(1) 缓冲相关接口

接口介绍 :

-- 接口名称 : MediaPlayer.OnBufferingUpdateListener;

-- 接口作用 : 定义一个回调接口, 该接口的作用是在流媒体缓冲状态发生改变的时候, 标明该状态;

接口方法介绍 :

-- 接口方法 :

public abstract void onBufferingUpdate (MediaPlayer mp, int percent)

-- 方法作用 : 该方法在 MediaPlayer 通过 HTTP 下载缓冲视频流的时候回调, 用以改变视频缓冲状态;

-- 方法參数 : mpMediaPlayer 实体对象; percent 已经缓冲了的 或者 播放了的 媒体流百分比;

(2) 播放完成相关接口

接口介绍 :

-- 接口名称 : MediaPlayer.OnCompletionListener;

-- 接口作用 : 在接口中定义了 流媒体 播放完成后回调的方法;

接口方法介绍 :

-- 接口方法 :

public abstract void onCompletion (MediaPlayer mp)

-- 方法作用 : 在 媒体流 播放完成之后回调;

(3) 错误相关接口

接口介绍 :

-- 接口名称 : MediaPlayer.OnErrorListener;

-- 接口作用 : 在该接口中定义回调方法, 在异步操作中出现错误时会回调该方法, 其他情况下出现错误时直接抛出异常;

接口方法介绍 :

-- 接口方法 :

public abstract boolean onError (MediaPlayer mp, int what, int extra)

-- 方法作用 : 异步操作中出现错误时回调该方法;

-- 參数介绍 :

--- a. MediaPlayer mp : MediaPlayer 实体类;

--- b. int what : 出现的错误类型, 如 

MEDIA_ERROR_UNKONWN(位置错误) 或者

MEDIA_ERROR_SERVER_DIED(server错误) ;

--- c. int extra : 针对与具体错误的附加码, 用于定位错误更具体信息, 比如

MEDIA_ERROR_IO(本地文件或网络相关错误),

MEDIA_ERROR_MALFORMAD (比特流不符合相关的编码标准和文件规范),

MEDIA_ERROR_UNSUPPORTED(框架不支持该功能),

MEDIA_ERROR_TIME_OUT(一些操作超时);

-- 方法执行结果 : 成功处理错误返回 true, 处理失败返回 false, 假设没有设定针对该方法的监听器, 直接调用 OnCompletionListener 监听器;

(4) 信息相关接口

接口介绍 :

-- 接口名称 : MediaPlayer.OnInfoListener;

-- 接口作用 : 该接口定义了一个回调方法, 该方法在媒体播放时出现信息或者警告时回调该方法;

接口方法介绍 :

-- 接口方法 :

public abstract boolean onInfo (MediaPlayer mp, int what, int extra)

-- 方法作用 : 出现了信息或者警告的时候回调;

-- 參数介绍 :

--- a. MediaPlayer mp : MediaPlayer 实体对象;

--- b. int what : 信息或者警告的类型, 如

MEDIA_INFO_UNKNOWN(未知的信息),

MEDIA_INFO_VEDIO_TRACK_LAGGING(视频过于复杂解码太慢),

MEDIA_INFO_VEDIO_RENDERING_START(開始渲染第一帧),

MEDIA_INFO_BUFFRING_START(暂停播放開始缓冲很多其他数据),

MEDIA_INFO_BUFFERING_END(缓冲了足够的数据又一次開始播放),

MEDIA_INFO_BAD_INTERLEAVING(错误交叉),

MEDIA_INFO_NOT_SEEKABLE(媒体不能够搜索),

MEDIA_INFO_METADATA_UPDATE(一组新的元数据用),

MEDIA_INFO_UNSUPPORTED_SUBTITLE(不支持字幕),

MEDIA_INFO_SUBTITLE_TIMED_OUT(读取字幕使用时间过长);

--- c. int extra : 信息或者警告的类型,

-- 返回值 : 假设处理了信息就会返回 true, 没有处理返回false, 假设没有注冊该监听, 就会忽略该信息;

(5) 准备播放相关接口

接口介绍 :

-- 接口名称 : MediaPlayer.OnPreparedListener;

-- 接口作用 : 该接口中定义一个回调方法, 该方法在进入 Prepared 状态 并 開始播放的时候回调;

接口方法介绍 :

-- 接口方法 :

public abstract void onPrepared (MediaPlayer mp)

-- 方法作用 : 该方法在进入 Prepared 状态 并 開始播放的时候回调;

-- 參数介绍 : MediaPlayer mp , MediaPlayer 实体对象;

(6) 查找操作相关接口

接口介绍 :

-- 接口名称 : MediaPlayer.OnSeekCompleteListener;

-- 接口作用 : 该接口定义了一个回调方法, 该方法在查找操作完成后回调;

接口方法介绍 :

-- 接口方法 :

public abstract void onSeekComplete (MediaPlayer mp)

-- 方法作用 : 查找操作完成的时候回调该方法;

(7) 视频大小相关接口

接口介绍 :

-- 接口名称 : MediaPlayer.OnVideSizeChangedListener;

-- 接口作用 : 该接口中定义了一个回调方法, 当视频大小首次被知晓或者更新的时候回调该方法;

接口方法介绍 :

-- 接口方法 :

public abstract void onVideoSizeChanged (MediaPlayer mp, int width, int height)

-- 方法作用 : 视频大小更新时回调该方法, 假设没有视频返回0;

-- 參数解析 : int width 视频的宽度, int height 视频的高度;

三. MediaPlayer 经常用法解析

1. MediaPlayer 构造方法

方法的注意点 : 使用 create() 方法创建的 MediaPlayer, 直接指定了 媒体资源, 不须要再进行 调用 prepare() 方法;

(1) 默认构造方法

方法名称 public MediaPlayer ();

public MediaPlayer ()

方法简单介绍 : 默认构造方法, 创建的 MediaPlayer 自己主动进入 Idle 状态, 不同于 create() 方法, 创建的 MediaPlayer 自己主动进入 Prepared 状态;

-- 两种方法比較 : 由于 create() 方法创建的时候就指定了数据源, 不用在 Idle 状态设置数据, 并调用 prepare() 方法了;

(2) 指定uri的构造方法

方法名称public static MediaPlayer create (Context context, Uri uri);

public static MediaPlayer create (Context context, Uri uri)

方法简单介绍 : 依据给定的 Uri 创建一个 MediaPlayer 对象, 假设创建成功, 其内部会自己主动调用 prepare() 方法, 不同再自己调用一次, MediaPlayer 使用完成之后要使用 release()方法, 否则会出错;

返回值 : 假设创建成功返回 MediaPlayer 对象, 假设创建失败返回 null;

參数介绍 :

-- Context context : Android 的上下文对象;

-- Uri uri : 数据源的 Uri;

(3) 指定资源 id

方法名称public static MediaPlayer create (Context context, int resid);

public static MediaPlayer create (Context context, int resid)

方法简单介绍 : 通过给定的 raw 资源 id, 创建 MediaPlayer 对象;

參数介绍 : int resid 设置播放源文件, 这里指的是 raw 资源 id;

(4) 指定 id 和 SurfaceView

方法名称public static MediaPlayer create (Context context, Uri uri, SurfaceHolder holder);

public static MediaPlayer create (Context context, Uri uri, SurfaceHolder holder)

方法简单介绍 : 创建一个 MediaPlayer, 指定 MediaPlayer 数据源 Uri 和 SurfaceView 对象;

參数介绍 :

-- Context context : Android 的上下文对象;

-- Uri uri : 指定的网络媒体的数据源;

-- SurfaceHolder holder : 指定要播放视频的 SurfaceHolder ;

2. 获取播放器相关属性方法

(1) 获取当前位置

方法名称public int getCurrentPosition ();

方法解析 : 获取当前播放器播放的位置, 返回值是 已经播放了的毫秒数;

方法的有效状态和无效状态 :

-- 有效状态 : Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, 在以上状态调用该方法不会改变 MediaPlayer 状态;

-- 无效状态 : Error 状态, 在 Error 状态调用该方法, 会进入 Error 状态中;

(2) 获取文件时长

方法名称public int getDuration ();

方法解析 : 获取文件的播放时长 (毫秒), 假设没有可用的时长, 就会返回 -1;

方法的有效状态和无效状态 : 设置数据源之后的非错误状态 才干够获取播放文件时长;

-- 有效状态 : PreparedStartedPausedStoppedPlaybackCompleted, 在以上状态调用该方法不会改变 MediaPlayer 状态;

-- 无效状态 : Idle, InitializedError 状态, 在 Error 状态调用该方法, 会进入 Error 状态中;

(3) 获取视频高度 宽度

方法名称 public int getVideoHeight (), public int getVideoWidth ();

方法解析 : 返回视频的高度 或者 宽度, 假设没有资源, 那么会返回0, 当视频大小改变的时候能够使用 MediaPlayer.OnVideoSizeChangedListener 监听其监听该事件;

方法的有效状态和无效状态 : 除 Error 以外的全部状态;

-- 有效状态 : IdleInitialized, PreparedStartedPausedStoppedPlaybackCompleted, 在以上状态调用该方法不会改变 MediaPlayer 状态;

-- 无效状态 : Error 状态, 在 Error 状态调用该方法, 会进入 Error 状态中;

(4) 检查 MediaPlayer 是否在循环

方法名称public boolean isLooping ();

方法解析 : 检查 MediaPlayer 是否在循环播放, 假设是 返回 true, 不是的话 返回 false;

方法的有效状态和无效状态 : 在不论什么状态都有效, 包含在 Error 状态的时候;

(5) 检查 MediaPlayer 是否在播放

方法名称public boolean isPlaying ();

方法解析 : 检查 MediaPlayer 是否正在播放;

方法的有效状态和无效状态 : 除 Error 以外的全部状态, 都能够查看 MediaPlayer 是否在播放;

-- 有效状态 : IdleInitialized, PreparedStartedPausedStoppedPlaybackCompleted, 在以上状态调用该方法不会改变 MediaPlayer 状态;

-- 无效状态 : Error 状态, 在 Error 状态调用该方法, 会进入 Error 状态, 抛出 IllegalStateException;

3. 状态迁移相关方法

(1) 暂停播放

方法名称public void pause ();

方法解析 : 暂停播放, 假设想要恢复播放的话, 调用 start() 方法;

方法的有效状态和无效状态 : 仅仅有在 Started 和 Paused 状态有效, Started 状态调用该方法进入 Paused 状态, Paused 状态调用该方法不起作用;

-- 有效状态 : StartedPaused, 在以上状态调用该方法不会改变 MediaPlayer 状态;

-- 无效状态 : Error , IdleInitialized, PreparedStoppedPlaybackCompleted 状态, 在 Error 状态调用该方法, 会进入 Error 状态, 抛出 IllegalStateException;

(2) 同步准备播放

方法名称public void prepare ();

方法解析 : 这是个同步方法, 设置完数据源播放载体之后调用该方法 或者 prepareAsync() 方法, 才干进行正常播放, 假设方法调用成功, 才干正常播放;

方法的有效状态和无效状态 : 仅仅有在 Initialized 和 Stopped 状态中会

-- 有效状态 : Initialized, Stopped, 在以上状态调用该方法不会改变 MediaPlayer 状态;

-- 无效状态 : IdlePreparedStartedPausedPlaybackCompletedError 状态, 在 Error 状态调用该方法, 会进入 Error 状态中;

(3) 异步准备播放

方法名称public void prepareAsync ();

方法作用 : 异步的方法, 让播放器处于准备状态;

-- 调用时机 : 设置完数据源 和 播放载体 之后调用该方法;

-- 适用情况 : 对于 流媒体 来说, 调用该方法马上返回, 要比 堵塞等待缓冲足够的数据在播放比較好;

方法的有效状态和无效状态 : 仅仅有在 Initialized 和 Stopped 状态中会

-- 有效状态 : Initialized, Stopped, 在以上状态调用该方法不会改变 MediaPlayer 状态;

-- 无效状态 : IdlePreparedStartedPausedPlaybackCompletedError 状态, 在 Error 状态调用该方法, 会进入 Error 状态中;

(4) 释放 MediaPlayer

方法名称 : public void release ();

方法解析 : 释放掉与 MediaPlayer 相关的资源;

-- 调用时机 : 在 MediaPlayer 播放的 Activity 暂停(pause) 停止(stop) 或者 销毁(destroy)  的时候要调用该方法释放 资源;

方法的有效状态和无效状态 : 在不论什么状态下 调用 release() 方法都能够;

(5) 重置 MediaPlayer

方法名称 public void reset ();

方法解析 : 重置 MediaPlayer 到 Idle 状态, 此时还没有设置数据源, 假设想要播放媒体资源, 须要设置数据源 和 调用 prepare()方法;

方法的有效状态和无效状态 : 在不论什么状态下 调用 release() 方法都能够;

4. 设置数据源相关方法

(1) 设置本地文件路径

方法名称public void setDataSource (String path);

方法解析 : 设置一个 文件路径 或者 http/rtsp 地址 当做数据源;

參数解析 : String path, 媒体资源的 文件路径 或者是 http/rtsp url 地址路径;

方法的有效状态和无效状态 : 仅仅有在 Idle 状态下才干设置数据源, 其他情况都会报错;

-- 有效状态 : Idle, 在以上状态调用该方法不会改变 MediaPlayer 状态;

-- 无效状态 : Initialized, PreparedStartedPausedStoppedPlaybackCompletedError, 状态, 在 Error 状态调用该方法, 会进入 Error 状态中;

(2) 设置文件描写叙述符

方法名称public void setDataSource (FileDescriptor fd);

方法解析 : 设置一个文件描写叙述符资源, 调用者应该注意关闭这个文件描写叙述符;

參数解析 : FileDescriptor sd, UNIX 系统的文件描写叙述, 相当与一个文件;

方法的有效状态和无效状态 : 仅仅有在 Idle 状态下才干设置数据源, 其他情况都会报错;

-- 有效状态 : Idle, 在以上状态调用该方法不会改变 MediaPlayer 状态;

-- 无效状态 : Initialized, PreparedStartedPausedStoppedPlaybackCompletedError, 状态, 在 Error 状态调用该方法, 会进入 Error 状态中;

(3) 设置数据源仅仅截取当中一段

方法名称public void setDataSource (FileDescriptor fd, long offset, long length);

方法解析 : 设置一个文件描写叙述符数据源, 这个文件描写叙述符文件必须是可查询的;

參数解析 :

-- FileDescriptor fd : 文件描写叙述符;

-- long offset : 文件開始播放的位置, 这里指的是字节数;

-- long length : 文件播放的大小, 字节数;

方法的有效状态和无效状态 : 仅仅有在 Idle 状态下才干设置数据源, 其他情况都会报错;

-- 有效状态 : Idle, 在以上状态调用该方法不会改变 MediaPlayer 状态;

-- 无效状态 : Initialized, PreparedStartedPausedStoppedPlaybackCompletedError, 状态, 在 Error 状态调用该方法, 会进入 Error 状态中;

(4) 设置 Uri 路径

方法名称public void setDataSource (Context context, Uri uri);

方法介绍 : 设置一个 Uri 路径当作数据源;

參数介绍 :

-- Context context : Android 上下文对象;

-- Uri uri : 网络媒体文件数据源;

方法的有效状态和无效状态 : 仅仅有在 Idle 状态下才干设置数据源, 其他情况都会报错;

-- 有效状态 : Idle, 在以上状态调用该方法不会改变 MediaPlayer 状态;

-- 无效状态 : Initialized, PreparedStartedPausedStoppedPlaybackCompletedError, 状态, 在 Error 状态调用该方法, 会进入 Error 状态中;

5. 设置监听器相关方法

注意 : 注冊监听器相关方法在 MediaPlayer 的不论什么状态都能够调用;

(1) 注冊缓冲变化相关监听器

方法名称public void setOnBufferingUpdateListener (MediaPlayer.OnBufferingUpdateListener listener);

方法作用 : 注冊一个在网络缓冲数据流发生变化后回调的监听器;

(2) 注冊播放完成监听器

方法名称 : public void setOnCompletionListener (MediaPlayer.OnCompletionListener listener);

方法作用 : 注冊一个在媒体资源播放完成之后回调的播放事件;

(3) 注冊错误监听器

方法名称public void setOnErrorListener (MediaPlayer.OnErrorListener listener);

方法解析 : 注冊一个在异步操作过程中错误发生回调的监听器;

(4) 注冊事件监听器

方法名称 : public void setOnInfoListener (MediaPlayer.OnInfoListener listener);

方法解析 : 注冊一个当有信息 或者 警告出现就会回调的监听器;

(5) 注冊准备播放监听器

方法名称public void setOnPreparedListener (MediaPlayer.OnPreparedListener listener);

方法解析 : 注冊一个当媒体资源准备播放时回调的监听器;

(6) 注冊搜寻操作监听器

方法名称public void setOnSeekCompleteListener (MediaPlayer.OnSeekCompleteListener listener);

方法解析 : 注冊一个搜寻操作完成后回调的监听器;

(7) 注冊视频大小改变监听器

方法名称public void setOnVideoSizeChangedListener (MediaPlayer.OnVideoSizeChangedListener listener);

方法解析 : 注冊一个 当视频大小已知 或者 更新后 回调的监听器;

6. MediaPlayer 其他设置

(1) 指定音频流类型

方法名称 : public void setAudioStreamType (int streamtype);

方法解析 : 为 MediaPlayer 设置音频流类型, 音频类型在 AudioManager 中定义, 该方法必须在 prepare() 或者 prepareAsync() 方法之前调用;

方法的有效状态和无效状态 :

-- 有效状态 : IdleInitialized, PreparedStartedPausedStoppedPlaybackCompleted, 在以上状态调用该方法会进入 Paused 状态;

-- 无效状态 : Error 状态, 在 Error 状态调用该方法, 会进入 Error 状态中;

(2) 设定播放载体

方法名称 public void setDisplay (SurfaceHolder sh);

方法解析 : 设定该媒体播放器的载体 SurfaceHolder, 假设要播放视频必须设置该项 或者 setSurface() 中的随意一个, 假设播放音频, 就不许要设置该该项, 假设播放视频没有设置该项, 那么仅仅会播放声音;

方法的有效状态和无效状态 : 在不论什么状态下都有效, 而且不会改变当前的执行状态;

(3) 设置循环播放

方法名称public void setLooping (boolean looping);

方法解析 : 设置播放器是否循环播放;

方法的有效状态和无效状态 :

-- 有效状态 : IdleInitialized, PreparedStartedPausedStoppedPlaybackCompleted, 在以上状态调用该方法不会改变当前状态;

-- 无效状态 : Error 状态, 在 Error 状态调用该方法, 会进入 Error 状态中;

(4) 设置是否保持屏幕

方法名称public void setScreenOnWhilePlaying (boolean screenOn);

方法解析: 设置在视频播放的时候是否使用 SurfaceHolder 保持屏幕亮起;

方法的有效状态和无效状态 : 不论什么状态都可调用, 而且不会改变当前状态;

(5) 设置电源管理状态

方法名称 public void setWakeMode (Context context, int mode);

方法解析 : 为 MediaPlayer 设置电源管理状态;

方法的有效状态和无效状态 : 不论什么状态都可调用, 而且不会改变当前状态;

作者 : 韩曙亮

转载请著名出处 :  http://blog.csdn.net/shulianghan/article/details/38487967

上一篇:XML的文档声明


下一篇:vs2017+opencv4.1.0配置文档