一. MediaPlayer 狀態(tài)機(jī) 介紹

Android MediaPlayer 狀態(tài)即圖例 :

1. Idle (閑置) 狀態(tài) 和 End (結(jié)束) 狀態(tài)

MediaPlayer 對(duì)象聲明周期 : 從 Idle 到 End 狀態(tài)就是 MediaPlayer 整個(gè)生命周期;

-- 生命周期開始 : 進(jìn)入 Idle (閑置) 狀態(tài);
-- 生命周期結(jié)束 : 進(jìn)入 End (結(jié)束) 狀態(tài);

Idle 和 End 狀態(tài)轉(zhuǎn)換 :

-- 進(jìn)入 Idle 狀態(tài) : MediaPlayer 剛被創(chuàng)建 new MediaPlayer() 或者 調(diào)用了 reset() 方法之后, 進(jìn)入 Idle (閑置) 狀態(tài);
-- 進(jìn)入 End 狀態(tài) : 在 Idle 狀態(tài)調(diào)用 release() 方法后, 會(huì)進(jìn)入 End (結(jié)束) 狀態(tài);

兩種進(jìn)入 Idle 狀態(tài)方法的差別 : 在 Idle 狀態(tài)無(wú)法調(diào)用 getCurrentPosition(), getDuration(), getVideoHeight(), getVideoWidth(), setAudioStreamtype(int), setLooping(boolean), setVolume(float, float), pause(), start(), stop(), seekTo(), prepare(), prepareAsync() 方法都是錯(cuò)誤的;

-- new MediaPlayer() 進(jìn)入 Idle 狀態(tài) : 此時(shí) MediaPlayer 內(nèi)部引擎 和 狀態(tài)都沒(méi)有改變, 調(diào)用上面的方法之后, 將 無(wú)法調(diào)用

OnErrorListener.onError() 方法;

-- reset() 進(jìn)入 Idle 狀態(tài) :  此時(shí)如果調(diào)用上面的方法, 內(nèi)部的引擎就會(huì) 回調(diào) OnErrorListener.onError() 方法;

創(chuàng)建 和 重載 MediaPlayer 區(qū)別 :

-- 創(chuàng)建 MediaPlayer : 通過(guò) new MediaPlayer() 創(chuàng)建的對(duì)象處于 Idle (閑置) 狀態(tài);
-- 重載 MediaPlayer : 通過(guò) create() 方法創(chuàng)建的 MediaPlayer 對(duì)象處于 Prepare (準(zhǔn)備) 狀態(tài);

End (結(jié)束) 狀態(tài)解析 :

-- release() 方法作用 : 該方法會(huì)釋放 播放引擎 中與 MediaPlayer 相關(guān)的資源;
-- 釋放唯一性資源 : 有些資源如 硬件加速組件 單態(tài)組件等都是唯一性的資源, 如果不釋放掉, 之后的 Mediaplayer 都無(wú)法正常運(yùn)行;
-- 無(wú)法進(jìn)行狀態(tài)轉(zhuǎn)換 : End 狀態(tài)代表 MediaPlayer 生命周期結(jié)束, 在此狀態(tài)不能轉(zhuǎn)換成其它狀態(tài)了;

2. Error (錯(cuò)誤) 狀態(tài)

Error 狀態(tài)轉(zhuǎn)換 : 當(dāng) MediaPlayer 出現(xiàn)一些錯(cuò)誤如 格式錯(cuò)誤, 分辨率過(guò)高等原因, 播放器引擎 就會(huì)調(diào)用 OnErrorListener.onError()方法;

-- 進(jìn)入 Error 狀態(tài) : 客戶端調(diào)用 OnErrorListener.onError() 方法, 會(huì)進(jìn)入 Error 狀態(tài);
-- 離開 Error 狀態(tài) : 如果想要使用進(jìn)入 Error 狀態(tài)的 MediaPlayer, 可以使用 reset() 方法進(jìn)入 Idle 狀態(tài);

注冊(cè)監(jiān)聽 : 編程注冊(cè)一個(gè) OnErrorListener 監(jiān)聽器, 用于獲取 播放器引擎 內(nèi)部發(fā)生的錯(cuò)誤;

-- 注冊(cè)方法 : 調(diào)用 MediaPlayer.setOnErrorListener(OnErrorListener) 方法, 注冊(cè) OnErrorListener;

關(guān)于一些異常拋出 : 在不合法的地方調(diào)用方法, 會(huì)拋出 IllegalStateException 異常;

3. Initalized (初始化) 狀態(tài)

Initialized 狀態(tài)轉(zhuǎn)換 : 在 Idle 狀態(tài)調(diào)用 setDataSource() 方法, MediaPlayer 會(huì)遷移到 Initialized 狀態(tài);
-- 注意 : 只能是在 Idle 狀態(tài)調(diào)用該方法, 如果在其它狀態(tài)調(diào)用該方法, 會(huì)報(bào)出 IllegalStateException 異常;

4. Prepared (就緒) 和 Preparing (準(zhǔn)備中) 狀態(tài)

Prepared (就緒) 狀態(tài)轉(zhuǎn)換 :

-- 從 Initialized 狀態(tài)遷移 : 在 Initialized 狀態(tài)調(diào)用 prepare() 方法, 如果方法成功返回, MediaPlayer 就會(huì)進(jìn)入 Prepared 狀態(tài);
-- 從 Preparing 狀態(tài)遷移 : 在 Preparing 狀態(tài)調(diào)用 OnPrepareListener.onPrepared() 方法遷移到 Prepared 狀態(tài);

Preparing (準(zhǔn)備中) 狀態(tài) : Initialized 狀態(tài)調(diào)用 prepareAsync() 方法進(jìn)入 Preparing 狀態(tài);

-- 該狀態(tài)執(zhí)行的操作 : 在 Preparing 狀態(tài)時(shí), 播放器引擎會(huì)繼續(xù)完成準(zhǔn)備工作, 同步版本返回 或者 異步版本準(zhǔn)備工作完成就會(huì)調(diào)用  OnPrepareListener.onPrepared() 方法進(jìn)入 Prepared 狀態(tài);

拋出異常 : 只有在 Initialized 方法中才能調(diào)用 prepare() 和 prepareAsync()方法, 在其它狀態(tài)調(diào)用會(huì)報(bào)出 IllegalStateException 遺產(chǎn);

Prepared 狀態(tài) MediaPlayer 可進(jìn)行的操作 : 在這個(gè)狀態(tài) MediaPlayer 可以進(jìn)行 音頻視頻屬性 循環(huán)屬性等操作;

5. Started (開始) 狀態(tài)

Started 狀態(tài)遷移 : 在 Prepared 狀態(tài)調(diào)用 start() 方法, MediaPlayer 即遷移到了 Started 狀態(tài);

-- 判斷 MediaPlayer 是否在 Started 狀態(tài) : 在任何狀態(tài)下調(diào)用 isPlaying() 方法, 可以判斷 MediaPlayer 是否在 Started 狀態(tài);
-- 跟蹤緩沖狀態(tài) : 在 Started 狀態(tài), 調(diào)用 OnBufferingUpdateListener.onBufferingUpdate() 方法, 可以獲取視頻音頻流的緩沖狀態(tài);

6. Paused (暫停) 狀態(tài)

Paused (暫停) 狀態(tài)遷移 : 在 Started 狀態(tài)調(diào)用 pause() 方法, MediaPlayer 會(huì)進(jìn)入 Paused 狀態(tài);

-- 狀態(tài)遷移時(shí)間 : Started 狀態(tài)轉(zhuǎn)換為 Paused 狀態(tài)需要一定時(shí)間, 這個(gè)過(guò)程是異步的, 過(guò)一段時(shí)間之后 isPlaying() 狀態(tài)才會(huì)改變;
-- 回到 Started 狀態(tài) : 在 Paused 狀態(tài)調(diào)用 start() 方法, 會(huì)進(jìn)入 Started 狀態(tài);

7. Stopped (停止) 狀態(tài)

Stopped 狀態(tài)遷移 : 在 Prepared, Started, Paused, PlaybackCompleted 狀態(tài)下 調(diào)用 stop() 方法, MediaPlayer 會(huì)遷移到 Stopped 狀態(tài);

8. 播放位置調(diào)整

seekTo() 方法說(shuō)明 : 該方法異步, 調(diào)用后 播放器引擎還需要進(jìn)行其它操作, 跳轉(zhuǎn)才能完成;

-- 進(jìn)行的操作 : 播放器引擎會(huì)回調(diào) OnSeekComplete.onSeekComplete()方法, 該方法通過(guò) setOnSeekCompleteListener() 方法注冊(cè);
-- seekTo() 方法調(diào)用狀態(tài) : 該方法可以在 Prepared, Paused, PlaybackCompleted 狀態(tài)進(jìn)行調(diào)用;
-- 獲取播放位置 : 調(diào)用 getCurrentPosition() 方法, 可以獲取當(dāng)前播放的位置, 可以幫助播放器更新進(jìn)度條;

9. PlaybackCompleted (播放完畢) 狀態(tài)

循環(huán)模式開啟 : 如果之前使用了 setLooping() 開啟了循環(huán)模式, 播放完畢之后 MediaPlayer 會(huì)重新進(jìn)入 Started 狀態(tài);

PlaybackCompleted 狀態(tài)遷移 : 如果沒(méi)有設(shè)置循環(huán)模式, 那么播放完畢之后會(huì)調(diào)用 OnCompletion.onCompletion() 回調(diào)方法, MediaPlayer 會(huì)進(jìn)入 PlaybackCompleted 狀態(tài);

-- OnCompletion注冊(cè) : 調(diào)用 MediaPlayer.setOnCompletionListener() 注冊(cè)該監(jiān)聽器;
-- 進(jìn)入 Started 狀態(tài)方法 : 在 PlaybackCompleted 狀態(tài)時(shí), 調(diào)用 satrt() 方法可以進(jìn)入 Started 狀態(tài);

二. MediaPlayer 接口 和 常量

1. MediaPlayer 接口

(1) 緩沖相關(guān)接口

接口介紹 :

-- 接口名稱 : MediaPlayer.OnBufferingUpdateListener;
-- 接口作用 : 定義一個(gè)回調(diào)接口, 該接口的作用是在流媒體緩沖狀態(tài)發(fā)生改變的時(shí)候, 標(biāo)明該狀態(tài);

接口方法介紹 :

-- 接口方法 :
public abstract void onBufferingUpdate (MediaPlayer mp, int percent) 
-- 方法作用 : 該方法在 MediaPlayer 通過(guò) HTTP 下載緩沖視頻流的時(shí)候回調(diào), 用以改變視頻緩沖狀態(tài);
-- 方法參數(shù) : mp 即 MediaPlayer 實(shí)體對(duì)象; percent 已經(jīng)緩沖了的 或者 播放了的 媒體流百分比;

(2) 播放完畢相關(guān)接口

接口介紹 :

-- 接口名稱 : MediaPlayer.OnCompletionListener;
-- 接口作用 : 在接口中定義了 流媒體 播放完畢后回調(diào)的方法;

接口方法介紹 :

-- 接口方法 :
public abstract void onCompletion (MediaPlayer mp) 
-- 方法作用 : 在 媒體流 播放完畢之后回調(diào);

(3) 錯(cuò)誤相關(guān)接口

接口介紹 :

-- 接口名稱 : MediaPlayer.OnErrorListener;
-- 接口作用 : 在該接口中定義回調(diào)方法, 在異步操作中出現(xiàn)錯(cuò)誤時(shí)會(huì)回調(diào)該方法, 其它情況下出現(xiàn)錯(cuò)誤時(shí)直接拋出異常;

接口方法介紹 :

-- 接口方法 :
public abstract boolean onError (MediaPlayer mp, int what, int extra) 
-- 方法作用 : 異步操作中出現(xiàn)錯(cuò)誤時(shí)回調(diào)該方法;
-- 參數(shù)介紹 :
--- a. MediaPlayer mp : MediaPlayer 實(shí)體類;
--- b. int what : 出現(xiàn)的錯(cuò)誤類型, 如
MEDIA_ERROR_UNKONWN(位置錯(cuò)誤) 或者
MEDIA_ERROR_SERVER_DIED(服務(wù)器錯(cuò)誤) ;
--- c. int extra : 針對(duì)與具體錯(cuò)誤的附加碼, 用于定位錯(cuò)誤更詳細(xì)信息, 例如
MEDIA_ERROR_IO(本地文件或網(wǎng)絡(luò)相關(guān)錯(cuò)誤),
MEDIA_ERROR_MALFORMAD (比特流不符合相關(guān)的編碼標(biāo)準(zhǔn)和文件規(guī)范),
MEDIA_ERROR_UNSUPPORTED(框架不支持該功能),
MEDIA_ERROR_TIME_OUT(一些操作超時(shí));

-- 方法執(zhí)行結(jié)果 : 成功處理錯(cuò)誤返回 true, 處理失敗返回 false, 如果沒(méi)有設(shè)定針對(duì)該方法的監(jiān)聽器, 直接調(diào)用 OnCompletionListener 監(jiān)聽器;

(4) 信息相關(guān)接口

接口介紹 :

-- 接口名稱 : MediaPlayer.OnInfoListener;
-- 接口作用 : 該接口定義了一個(gè)回調(diào)方法, 該方法在媒體播放時(shí)出現(xiàn)信息或者警告時(shí)回調(diào)該方法;

接口方法介紹 :

-- 接口方法 :

public abstract boolean onInfo (MediaPlayer mp, int what, int extra) 
-- 方法作用 : 出現(xiàn)了信息或者警告的時(shí)候回調(diào);
-- 參數(shù)介紹 :
--- a. MediaPlayer mp : MediaPlayer 實(shí)體對(duì)象;

--- b. int what : 信息或者警告的類型, 如
MEDIA_INFO_UNKNOWN(未知的信息),
MEDIA_INFO_VEDIO_TRACK_LAGGING(視頻過(guò)于復(fù)雜解碼太慢),
MEDIA_INFO_VEDIO_RENDERING_START(開始渲染第一幀),
MEDIA_INFO_BUFFRING_START(暫停播放開始緩沖更多數(shù)據(jù)),
MEDIA_INFO_BUFFERING_END(緩沖了足夠的數(shù)據(jù)重新開始播放),
MEDIA_INFO_BAD_INTERLEAVING(錯(cuò)誤交叉),
MEDIA_INFO_NOT_SEEKABLE(媒體不能夠搜索),
MEDIA_INFO_METADATA_UPDATE(一組新的元數(shù)據(jù)用),
MEDIA_INFO_UNSUPPORTED_SUBTITLE(不支持字幕),
MEDIA_INFO_SUBTITLE_TIMED_OUT(讀取字幕使用時(shí)間過(guò)長(zhǎng));
--- c. int extra : 信息或者警告的類型,

-- 返回值 : 如果處理了信息就會(huì)返回 true, 沒(méi)有處理返回false, 如果沒(méi)有注冊(cè)該監(jiān)聽, 就會(huì)忽略該信息;

(5) 準(zhǔn)備播放相關(guān)接口

接口介紹 :

-- 接口名稱 : MediaPlayer.OnPreparedListener;
-- 接口作用 : 該接口中定義一個(gè)回調(diào)方法, 該方法在進(jìn)入 Prepared 狀態(tài) 并 開始播放的時(shí)候回調(diào);

接口方法介紹 :

-- 接口方法 :

public abstract void onPrepared (MediaPlayer mp) 
-- 方法作用 : 該方法在進(jìn)入 Prepared 狀態(tài) 并 開始播放的時(shí)候回調(diào);
-- 參數(shù)介紹 : MediaPlayer mp , MediaPlayer 實(shí)體對(duì)象;

(6) 查找操作相關(guān)接口

接口介紹 :

-- 接口名稱 : MediaPlayer.OnSeekCompleteListener;
-- 接口作用 : 該接口定義了一個(gè)回調(diào)方法, 該方法在查找操作完成后回調(diào);

接口方法介紹 :

-- 接口方法 :
public abstract void onSeekComplete (MediaPlayer mp) 
-- 方法作用 : 查找操作完成的時(shí)候回調(diào)該方法;

(7) 視頻大小相關(guān)接口

接口介紹 :

-- 接口名稱 : MediaPlayer.OnVideSizeChangedListener;
-- 接口作用 : 該接口中定義了一個(gè)回調(diào)方法, 當(dāng)視頻大小首次被知曉或者更新的時(shí)候回調(diào)該方法;

接口方法介紹 :

-- 接口方法 :

public abstract void onVideoSizeChanged (MediaPlayer mp, int width, int height) 
-- 方法作用 : 視頻大小更新時(shí)回調(diào)該方法, 如果沒(méi)有視頻返回0;
-- 參數(shù)解析 : int width 視頻的寬度, int height 視頻的高度;

三. MediaPlayer 常用方法解析

1. MediaPlayer 構(gòu)造方法

方法的注意點(diǎn) : 使用 create() 方法創(chuàng)建的 MediaPlayer, 直接指定了 媒體資源, 不需要再進(jìn)行 調(diào)用 prepare() 方法;

(1) 默認(rèn)構(gòu)造方法

方法名稱 : public MediaPlayer ();

public MediaPlayer () 

方法簡(jiǎn)介 : 默認(rèn)構(gòu)造方法, 創(chuàng)建的 MediaPlayer 自動(dòng)進(jìn)入 Idle 狀態(tài), 不同于 create() 方法, 創(chuàng)建的 MediaPlayer 自動(dòng)進(jìn)入 Prepared 狀態(tài);

-- 兩種方法比較 : 因?yàn)?create() 方法創(chuàng)建的時(shí)候就指定了數(shù)據(jù)源, 不用在 Idle 狀態(tài)設(shè)置數(shù)據(jù), 并調(diào)用 prepare() 方法了;

(2) 指定uri的構(gòu)造方法

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

public static MediaPlayer create (Context context, Uri uri) 

方法簡(jiǎn)介 : 根據(jù)給定的 Uri 創(chuàng)建一個(gè) MediaPlayer 對(duì)象, 如果創(chuàng)建成功, 其內(nèi)部會(huì)自動(dòng)調(diào)用 prepare() 方法, 不同再自己調(diào)用一次, MediaPlayer 使用完畢之后要使用 release()方法, 否則會(huì)出錯(cuò);

返回值 : 如果創(chuàng)建成功返回 MediaPlayer 對(duì)象, 如果創(chuàng)建失敗返回 null;

參數(shù)介紹 :

-- Context context : android 的上下文對(duì)象;
-- Uri uri : 數(shù)據(jù)源的 Uri;

(3) 指定資源 id

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

public static MediaPlayer create (Context context, int resid) 

方法簡(jiǎn)介 : 通過(guò)給定的 raw 資源 id, 創(chuàng)建 MediaPlayer 對(duì)象;

參數(shù)介紹 : int resid 設(shè)置播放源文件, 這里指的是 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) 

方法簡(jiǎn)介 : 創(chuàng)建一個(gè) MediaPlayer, 指定 MediaPlayer 數(shù)據(jù)源 Uri 和 SurfaceView 對(duì)象;

參數(shù)介紹 :

-- Context context : Android 的上下文對(duì)象;
-- Uri uri : 指定的網(wǎng)絡(luò)媒體的數(shù)據(jù)源;
-- SurfaceHolder holder : 指定要播放視頻的 SurfaceHolder ;

2. 獲取播放器相關(guān)屬性方法

(1) 獲取當(dāng)前位置

方法名稱 : public int getCurrentPosition ();

方法解析 : 獲取當(dāng)前播放器播放的位置, 返回值是 已經(jīng)播放了的毫秒數(shù);

方法的有效狀態(tài)和無(wú)效狀態(tài) :

-- 有效狀態(tài) : Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, 在以上狀態(tài)調(diào)用該方法不會(huì)改變 MediaPlayer 狀態(tài);
-- 無(wú)效狀態(tài) : Error 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài)中;

(2) 獲取文件時(shí)長(zhǎng)

方法名稱 : public int getDuration ();

方法解析 : 獲取文件的播放時(shí)長(zhǎng) (毫秒), 如果沒(méi)有可用的時(shí)長(zhǎng), 就會(huì)返回 -1;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 設(shè)置數(shù)據(jù)源之后的非錯(cuò)誤狀態(tài) 才可以獲取播放文件時(shí)長(zhǎng);

-- 有效狀態(tài) : Prepared, Started, Paused, Stopped, PlaybackCompleted, 在以上狀態(tài)調(diào)用該方法不會(huì)改變 MediaPlayer 狀態(tài);
-- 無(wú)效狀態(tài) : Idle, Initialized, Error 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài)中;

(3) 獲取視頻高度 寬度

方法名稱 : public int getVideoHeight (), public int getVideoWidth ();

方法解析 : 返回視頻的高度 或者 寬度, 如果沒(méi)有資源, 那么會(huì)返回0, 當(dāng)視頻大小改變的時(shí)候可以使用 MediaPlayer.OnVideoSizeChangedListener 監(jiān)聽其監(jiān)聽該事件;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 除 Error 以外的所有狀態(tài);

-- 有效狀態(tài) : Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, 在以上狀態(tài)調(diào)用該方法不會(huì)改變 MediaPlayer 狀態(tài);
-- 無(wú)效狀態(tài) : Error 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài)中;

(4) 檢查 MediaPlayer 是否在循環(huán)

方法名稱 : public boolean isLooping ();

方法解析 : 檢查 MediaPlayer 是否在循環(huán)播放, 如果是 返回 true, 不是的話 返回 false;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 在任何狀態(tài)都有效, 包括在 Error 狀態(tài)的時(shí)候;

(5) 檢查 MediaPlayer 是否在播放

方法名稱 : public boolean isPlaying ();

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

方法的有效狀態(tài)和無(wú)效狀態(tài) : 除 Error 以外的所有狀態(tài), 都可以查看 MediaPlayer 是否在播放;

-- 有效狀態(tài) : Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, 在以上狀態(tài)調(diào)用該方法不會(huì)改變 MediaPlayer 狀態(tài);
-- 無(wú)效狀態(tài) : Error 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài), 拋出 IllegalStateException;

3. 狀態(tài)遷移相關(guān)方法

(1) 暫停播放

方法名稱 : public void pause ();

方法解析 : 暫停播放, 如果想要恢復(fù)播放的話, 調(diào)用 start() 方法;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 只有在 Started 和 Paused 狀態(tài)有效, Started 狀態(tài)調(diào)用該方法進(jìn)入 Paused 狀態(tài), Paused 狀態(tài)調(diào)用該方法不起作用;

-- 有效狀態(tài) : Started, Paused, 在以上狀態(tài)調(diào)用該方法不會(huì)改變 MediaPlayer 狀態(tài);
-- 無(wú)效狀態(tài) : Error , Idle, Initialized, Prepared, Stopped, PlaybackCompleted 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài), 拋出 IllegalStateException;

(2) 同步準(zhǔn)備播放

方法名稱 : public void prepare ();

方法解析 : 這是個(gè)同步方法, 設(shè)置完數(shù)據(jù)源 和 播放載體之后調(diào)用該方法 或者 prepareAsync() 方法, 才能進(jìn)行正常播放, 如果方法調(diào)用成功, 才能正常播放;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 只有在 Initialized 和 Stopped 狀態(tài)中會(huì)
-- 有效狀態(tài) : Initialized, Stopped, 在以上狀態(tài)調(diào)用該方法不會(huì)改變 MediaPlayer 狀態(tài);
-- 無(wú)效狀態(tài) : Idle, Prepared, Started, Paused, PlaybackCompleted, Error 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài)中;

(3) 異步準(zhǔn)備播放

方法名稱 : public void prepareAsync ();

方法作用 : 異步的方法, 讓播放器處于準(zhǔn)備狀態(tài);

-- 調(diào)用時(shí)機(jī) : 設(shè)置完數(shù)據(jù)源 和 播放載體 之后調(diào)用該方法;
-- 適用情況 : 對(duì)于 流媒體 來(lái)說(shuō), 調(diào)用該方法立即返回, 要比 阻塞等待緩沖足夠的數(shù)據(jù)在播放比較好;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 只有在 Initialized 和 Stopped 狀態(tài)中會(huì)

-- 有效狀態(tài) : Initialized, Stopped, 在以上狀態(tài)調(diào)用該方法不會(huì)改變 MediaPlayer 狀態(tài);
-- 無(wú)效狀態(tài) : Idle, Prepared, Started, Paused, PlaybackCompleted, Error 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài)中;

(4) 釋放 MediaPlayer

方法名稱 : public void release ();

方法解析 : 釋放掉與 MediaPlayer 相關(guān)的資源;

-- 調(diào)用時(shí)機(jī) : 在 MediaPlayer 播放的 Activity 暫停(pause) 停止(stop) 或者 銷毀(destroy)  的時(shí)候要調(diào)用該方法釋放 資源;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 在任何狀態(tài)下 調(diào)用 release() 方法都可以;

(5) 重置 MediaPlayer

方法名稱 : public void reset ();

方法解析 : 重置 MediaPlayer 到 Idle 狀態(tài), 此時(shí)還沒(méi)有設(shè)置數(shù)據(jù)源, 如果想要播放媒體資源, 需要設(shè)置數(shù)據(jù)源 和 調(diào)用 prepare()方法;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 在任何狀態(tài)下 調(diào)用 release() 方法都可以;

4. 設(shè)置數(shù)據(jù)源相關(guān)方法

(1) 設(shè)置本地文件路徑

方法名稱 : public void setDataSource (String path);

方法解析 : 設(shè)置一個(gè) 文件路徑 或者 http/rtsp 地址 當(dāng)做數(shù)據(jù)源;

參數(shù)解析 : String path, 媒體資源的 文件路徑 或者是 http/rtsp url 地址路徑;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 只有在 Idle 狀態(tài)下才能設(shè)置數(shù)據(jù)源, 其它情況都會(huì)報(bào)錯(cuò);

-- 有效狀態(tài) : Idle, 在以上狀態(tài)調(diào)用該方法不會(huì)改變 MediaPlayer 狀態(tài);
-- 無(wú)效狀態(tài) : Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error, 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài)中;

(2) 設(shè)置文件描述符

方法名稱 : public void setDataSource (FileDescriptor fd);

方法解析 : 設(shè)置一個(gè)文件描述符資源, 調(diào)用者應(yīng)該注意關(guān)閉這個(gè)文件描述符;

參數(shù)解析 : FileDescriptor sd, UNIX 系統(tǒng)的文件描述, 相當(dāng)與一個(gè)文件;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 只有在 Idle 狀態(tài)下才能設(shè)置數(shù)據(jù)源, 其它情況都會(huì)報(bào)錯(cuò);

-- 有效狀態(tài) : Idle, 在以上狀態(tài)調(diào)用該方法不會(huì)改變 MediaPlayer 狀態(tài);
-- 無(wú)效狀態(tài) : Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error, 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài)中;

(3) 設(shè)置數(shù)據(jù)源只截取其中一段

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

方法解析 : 設(shè)置一個(gè)文件描述符數(shù)據(jù)源, 這個(gè)文件描述符文件必須是可查詢的;

參數(shù)解析 :

-- FileDescriptor fd : 文件描述符;
-- long offset : 文件開始播放的位置, 這里指的是字節(jié)數(shù);
-- long length : 文件播放的大小, 字節(jié)數(shù);

方法的有效狀態(tài)和無(wú)效狀態(tài) : 只有在 Idle 狀態(tài)下才能設(shè)置數(shù)據(jù)源, 其它情況都會(huì)報(bào)錯(cuò);

-- 有效狀態(tài) : Idle, 在以上狀態(tài)調(diào)用該方法不會(huì)改變 MediaPlayer 狀態(tài);
-- 無(wú)效狀態(tài) : Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error, 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài)中;

(4) 設(shè)置 Uri 路徑

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

方法介紹 : 設(shè)置一個(gè) Uri 路徑當(dāng)作數(shù)據(jù)源;

參數(shù)介紹 :

-- Context context : Android 上下文對(duì)象;
-- Uri uri : 網(wǎng)絡(luò)媒體文件數(shù)據(jù)源;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 只有在 Idle 狀態(tài)下才能設(shè)置數(shù)據(jù)源, 其它情況都會(huì)報(bào)錯(cuò);

-- 有效狀態(tài) : Idle, 在以上狀態(tài)調(diào)用該方法不會(huì)改變 MediaPlayer 狀態(tài);
-- 無(wú)效狀態(tài) : Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error, 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài)中;

5. 設(shè)置監(jiān)聽器相關(guān)方法

注意 : 注冊(cè)監(jiān)聽器相關(guān)方法在 MediaPlayer 的任何狀態(tài)都可以調(diào)用;

(1) 注冊(cè)緩沖變化相關(guān)監(jiān)聽器

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

方法作用 : 注冊(cè)一個(gè)在網(wǎng)絡(luò)緩沖數(shù)據(jù)流發(fā)生變化后回調(diào)的監(jiān)聽器;

(2) 注冊(cè)播放完畢監(jiān)聽器

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

方法作用 : 注冊(cè)一個(gè)在媒體資源播放完畢之后回調(diào)的播放事件;

(3) 注冊(cè)錯(cuò)誤監(jiān)聽器

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

方法解析 : 注冊(cè)一個(gè)在異步操作過(guò)程中發(fā)生錯(cuò)誤回調(diào)的監(jiān)聽器;

(4) 注冊(cè)事件監(jiān)聽器

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

方法解析 : 注冊(cè)一個(gè)當(dāng)有信息 或者 警告出現(xiàn)就會(huì)回調(diào)的監(jiān)聽器;

(5) 注冊(cè)準(zhǔn)備播放監(jiān)聽器

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

方法解析 : 注冊(cè)一個(gè)當(dāng)媒體資源準(zhǔn)備播放時(shí)回調(diào)的監(jiān)聽器;

(6) 注冊(cè)搜尋操作監(jiān)聽器

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

方法解析 : 注冊(cè)一個(gè)搜尋操作完成后回調(diào)的監(jiān)聽器;

(7) 注冊(cè)視頻大小改變監(jiān)聽器

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

方法解析 : 注冊(cè)一個(gè) 當(dāng)視頻大小已知 或者 更新后 回調(diào)的監(jiān)聽器;

6. MediaPlayer 其它設(shè)置

(1) 指定音頻流類型

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

方法解析 : 為 MediaPlayer 設(shè)置音頻流類型, 音頻類型在 AudioManager 中定義, 該方法必須在 prepare() 或者 prepareAsync() 方法之前調(diào)用;

方法的有效狀態(tài)和無(wú)效狀態(tài) :

-- 有效狀態(tài) : Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, 在以上狀態(tài)調(diào)用該方法會(huì)進(jìn)入 Paused 狀態(tài);
-- 無(wú)效狀態(tài) : Error 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài)中;

(2) 設(shè)定播放載體

方法名稱 : public void setDisplay (SurfaceHolder sh);

方法解析 : 設(shè)定該媒體播放器的載體 SurfaceHolder, 如果要播放視頻必須設(shè)置該項(xiàng) 或者 setSurface() 中的任意一個(gè), 如果播放音頻, 就不許要設(shè)置該該項(xiàng), 如果播放視頻沒(méi)有設(shè)置該項(xiàng), 那么只會(huì)播放聲音;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 在任何狀態(tài)下都有效, 并且不會(huì)改變當(dāng)前的運(yùn)行狀態(tài);

(3) 設(shè)置循環(huán)播放

方法名稱 : public void setLooping (boolean looping);

方法解析 : 設(shè)置播放器是否循環(huán)播放;

方法的有效狀態(tài)和無(wú)效狀態(tài) :

-- 有效狀態(tài) : Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, 在以上狀態(tài)調(diào)用該方法不會(huì)改變當(dāng)前狀態(tài);
-- 無(wú)效狀態(tài) : Error 狀態(tài), 在 Error 狀態(tài)調(diào)用該方法, 會(huì)進(jìn)入 Error 狀態(tài)中;

(4) 設(shè)置是否保持屏幕

方法名稱 : public void setScreenOnWhilePlaying (boolean screenOn);

方法解析: 設(shè)置在視頻播放的時(shí)候是否使用 SurfaceHolder 保持屏幕亮起;

方法的有效狀態(tài)和無(wú)效狀態(tài) : 任何狀態(tài)都可調(diào)用, 并且不會(huì)改變當(dāng)前狀態(tài);

(5) 設(shè)置電源管理狀態(tài)

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

方法解析 : 為 MediaPlayer 設(shè)置電源管理狀態(tài);

方法的有效狀態(tài)和無(wú)效狀態(tài) : 任何狀態(tài)都可調(diào)用, 并且不會(huì)改變當(dāng)前狀態(tài);

總結(jié)

以上所述是小編給大家介紹的Android 媒體開發(fā)之MediaPlayer 狀態(tài)機(jī) 接口方法實(shí)例解析，希望對(duì)大家有所幫助，如果大家有任何疑問(wèn)請(qǐng)給我留言，小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)腳本之家網(wǎng)站的支持！