Android 媒体开发之MediaPlayer状态机接口方法实例解析

一. mediaplayer 状态机 介绍

android mediaplayer 状态即图例 :

1. idle (闲置) 状态 和 end (结束) 状态

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 (错误) 状态

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

-- 进入 error 状态 : 客户端调用 onerrorlistener.onerror() 方法, 会进入 error 状态;
-- 离开 error 状态 : 如果想要使用进入 error 状态的 mediaplayer, 可以使用 reset() 方法进入 idle 状态;

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

-- 注册方法 : 调用 mediaplayer.setonerrorlistener(onerrorlistener) 方法, 注册 onerrorlistener;

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

3. initalized (初始化) 状态

initialized 状态转换 : 在 idle 状态调用 setdatasource() 方法, mediaplayer 会迁移到 initialized 状态;
-- 注意 : 只能是在 idle 状态调用该方法, 如果在其它状态调用该方法, 会报出 illegalstateexception 异常;

4. prepared (就绪) 和 preparing (准备中) 状态

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 (开始) 状态

started 状态迁移 : 在 prepared 状态调用 start() 方法, mediaplayer 即迁移到了 started 状态;

-- 判断 mediaplayer 是否在 started 状态 : 在任何状态下调用 isplaying() 方法, 可以判断 mediaplayer 是否在 started 状态;
-- 跟踪缓冲状态 : 在 started 状态, 调用 onbufferingupdatelistener.onbufferingupdate() 方法, 可以获取视频音频流的缓冲状态;

6. paused (暂停) 状态

paused (暂停) 状态迁移 : 在 started 状态调用 pause() 方法, mediaplayer 会进入 paused 状态;

-- 状态迁移时间 : started 状态转换为 paused 状态需要一定时间, 这个过程是异步的, 过一段时间之后 isplaying() 状态才会改变;
-- 回到 started 状态 : 在 paused 状态调用 start() 方法, 会进入 started 状态;

7. stopped (停止) 状态

stopped 状态迁移 : 在 prepared, started, paused, playbackcompleted 状态下 调用 stop() 方法, mediaplayer 会迁移到 stopped 状态;

8. 播放位置调整

                

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

-- 进行的操作 : 播放器引擎会回调 onseekcomplete.onseekcomplete()方法, 该方法通过 setonseekcompletelistener() 方法注册;
-- seekto() 方法调用状态 : 该方法可以在 prepared, paused, playbackcompleted 状态进行调用;
-- 获取播放位置 : 调用 getcurrentposition() 方法, 可以获取当前播放的位置, 可以帮助播放器更新进度条;

9. playbackcompleted (播放完毕) 状态

循环模式开启 : 如果之前使用了 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 下载缓冲视频流的时候回调, 用以改变视频缓冲状态;
-- 方法参数 : mp 即 mediaplayer 实体对象; 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(服务器错误) ;
--- 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;

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

-- 有效状态 : prepared, started, paused, stopped, playbackcompleted, 在以上状态调用该方法不会改变 mediaplayer 状态;
-- 无效状态 : idle, initialized, error 状态, 在 error 状态调用该方法, 会进入 error 状态中;

(3) 获取视频高度 宽度

方法名称 : public int getvideoheight (), public int getvideowidth ();

方法解析 : 返回视频的高度 或者 宽度, 如果没有资源, 那么会返回0, 当视频大小改变的时候可以使用 mediaplayer.onvideosizechangedlistener 监听其监听该事件;

方法的有效状态和无效状态 : 除 error 以外的所有状态;

-- 有效状态 : idle, initialized, prepared, started, paused, stopped, playbackcompleted, 在以上状态调用该方法不会改变 mediaplayer 状态;
-- 无效状态 : error 状态, 在 error 状态调用该方法, 会进入 error 状态中;

(4) 检查 mediaplayer 是否在循环

方法名称 : public boolean islooping ();

方法解析 : 检查 mediaplayer 是否在循环播放, 如果是 返回 true, 不是的话 返回 false;

方法的有效状态和无效状态 : 在任何状态都有效, 包括在 error 状态的时候;

(5) 检查 mediaplayer 是否在播放

方法名称 : public boolean isplaying ();

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

方法的有效状态和无效状态 : 除 error 以外的所有状态, 都可以查看 mediaplayer 是否在播放;

-- 有效状态 : idle, initialized, prepared, started, paused, stopped, playbackcompleted, 在以上状态调用该方法不会改变 mediaplayer 状态;
-- 无效状态 : error 状态, 在 error 状态调用该方法, 会进入 error 状态, 抛出 illegalstateexception;

3. 状态迁移相关方法

(1) 暂停播放

方法名称 : public void pause ();

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

方法的有效状态和无效状态 : 只有在 started 和 paused 状态有效, started 状态调用该方法进入 paused 状态, paused 状态调用该方法不起作用;

-- 有效状态 : started, paused, 在以上状态调用该方法不会改变 mediaplayer 状态;
-- 无效状态 : error , idle, initialized, prepared, stopped, playbackcompleted 状态, 在 error 状态调用该方法, 会进入 error 状态, 抛出 illegalstateexception;

(2) 同步准备播放

方法名称 : public void prepare ();

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

方法的有效状态和无效状态 : 只有在 initialized 和 stopped 状态中会
-- 有效状态 : initialized, stopped, 在以上状态调用该方法不会改变 mediaplayer 状态;
-- 无效状态 : idle, prepared, started, paused, playbackcompleted, error 状态, 在 error 状态调用该方法, 会进入 error 状态中;

(3) 异步准备播放

方法名称 : public void prepareasync ();

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

-- 调用时机 : 设置完数据源 和 播放载体 之后调用该方法;
-- 适用情况 : 对于 流媒体 来说, 调用该方法立即返回, 要比 阻塞等待缓冲足够的数据在播放比较好;

方法的有效状态和无效状态 : 只有在 initialized 和 stopped 状态中会

-- 有效状态 : initialized, stopped, 在以上状态调用该方法不会改变 mediaplayer 状态;
-- 无效状态 : idle, prepared, started, paused, playbackcompleted, error 状态, 在 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, prepared, started, paused, stopped, playbackcompleted, error, 状态, 在 error 状态调用该方法, 会进入 error 状态中;

(2) 设置文件描述符

方法名称 : public void setdatasource (filedescriptor fd);

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

参数解析 : filedescriptor sd, unix 系统的文件描述, 相当与一个文件;

方法的有效状态和无效状态 : 只有在 idle 状态下才能设置数据源, 其它情况都会报错;

-- 有效状态 : idle, 在以上状态调用该方法不会改变 mediaplayer 状态;
-- 无效状态 : initialized, prepared, started, paused, stopped, playbackcompleted, error, 状态, 在 error 状态调用该方法, 会进入 error 状态中;

(3) 设置数据源只截取其中一段

方法名称 : public void setdatasource (filedescriptor fd, long offset, long length);

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

参数解析 :

-- filedescriptor fd : 文件描述符;
-- long offset : 文件开始播放的位置, 这里指的是字节数;
-- long length : 文件播放的大小, 字节数;

方法的有效状态和无效状态 : 只有在 idle 状态下才能设置数据源, 其它情况都会报错;

-- 有效状态 : idle, 在以上状态调用该方法不会改变 mediaplayer 状态;
-- 无效状态 : initialized, prepared, started, paused, stopped, playbackcompleted, error, 状态, 在 error 状态调用该方法, 会进入 error 状态中;

(4) 设置 uri 路径

方法名称 : public void setdatasource (context context, uri uri);

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

参数介绍 :

-- context context : android 上下文对象;
-- uri uri : 网络媒体文件数据源;

方法的有效状态和无效状态 : 只有在 idle 状态下才能设置数据源, 其它情况都会报错;

-- 有效状态 : idle, 在以上状态调用该方法不会改变 mediaplayer 状态;
-- 无效状态 : initialized, prepared, started, paused, stopped, playbackcompleted, error, 状态, 在 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() 方法之前调用;

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

-- 有效状态 : idle, initialized, prepared, started, paused, stopped, playbackcompleted, 在以上状态调用该方法会进入 paused 状态;
-- 无效状态 : error 状态, 在 error 状态调用该方法, 会进入 error 状态中;

(2) 设定播放载体

方法名称 : public void setdisplay (surfaceholder sh);

方法解析 : 设定该媒体播放器的载体 surfaceholder, 如果要播放视频必须设置该项 或者 setsurface() 中的任意一个, 如果播放音频, 就不许要设置该该项, 如果播放视频没有设置该项, 那么只会播放声音;

方法的有效状态和无效状态 : 在任何状态下都有效, 并且不会改变当前的运行状态;

(3) 设置循环播放

方法名称 : public void setlooping (boolean looping);

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

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

-- 有效状态 : idle, initialized, prepared, started, paused, stopped, playbackcompleted, 在以上状态调用该方法不会改变当前状态;
-- 无效状态 : error 状态, 在 error 状态调用该方法, 会进入 error 状态中;

(4) 设置是否保持屏幕

方法名称 : public void setscreenonwhileplaying (boolean screenon);

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

方法的有效状态和无效状态 : 任何状态都可调用, 并且不会改变当前状态;

(5) 设置电源管理状态

方法名称 : public void setwakemode (context context, int mode);

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

方法的有效状态和无效状态 : 任何状态都可调用, 并且不会改变当前状态;

总结

以上所述是小编给大家介绍的android 媒体开发之mediaplayer 状态机 接口方法实例解析，希望对大家有所帮助