全志R11_tinav2.5_tplayer播放器接口說明書

2. TPlayer 狀態圖及狀態說明
2.1. TPlayer 狀態圖

這張狀態轉換圖清晰地描述了 TPlayer 的各個狀態，也列舉了主要的方法的調用時序，每種方法只能在一些特定的狀態下使用，不然會出錯

另外，只有在 Prepared、Started、Paused、PlaybackCompleted 這四種狀態下能夠進行 TPlayerSeekTo()操做，而且 TPlayerSeekTo()以後，狀態不變。

2.2. TPlayer 每一個狀態簡要說明
2.2.1. Idle 狀態
Idle 狀態：當調用 TPlayerCreate()建立一個 TPlayer 或者調用了其 TPlayerReset()方法時，TPlayer 處於
idle 狀態。

2.2.2. Initialized 狀態
這個狀態比較簡單，調用 TPlayerSetDataSource()方法就進入 Initialized 狀態，表示此時要播放的文件已經設置好了。

2.2.3. Preparing 狀態
這個狀態比較好理解，主要是和 TPlayerPrepareAsync()配合，若是異步準備完成，會經過這個TPLAYER_NOTIFY_PREPARED 消息回調上來，進而進入 Prepared 狀態

2.2.4. Prepared 狀態
初始化完成以後還須要經過調用 TPlayerPrepare()或 TPlayerPrepareAsync()方法，這兩個方法一個是同步的一個是異步的，只有進入 Prepared 狀態，才代表 TPlayer 到目前爲止都沒有錯誤，能夠進行文件播放

2.2.5. Started 狀態
TPlayer 一旦準備好，就能夠調用 TPlayerStart()方法，這樣 TPlayer 就處於 Started 狀態，這代表 TPlayer正在播放文件過程當中。可使用 TPlayerIsPlaying()測試 TPlayer 是否處於了 Started 狀態。若是播放完畢，而又設置了循環播放，則 TPlayer 仍然會處於 Started 狀態。

2.2.6. Paused 狀態
Started 狀態下能夠調用 TPlayerPause()方法暫停 TPlayer，從而進入 Paused 狀態，TPlayer 暫停後再次調用 TPlayerStart()則能夠繼續 TPlayer 的播放，轉到 Started 狀態。

2.2.7. Stopped 狀態
Started 或者 Paused 狀態下都可調用 TPlayerStop()中止 TPlayer，而處於 Stop 狀態的 TPlayer 要想從新播放，須要經過 TPlayerPrepareAsync()和 TPlayerPrepare()回到先前的 Prepared 狀態從新開始才能夠

2.2.8. PlaybackCompleted 狀態
文 件 正 常 播 放 完 畢 ， 而 又 沒 有 設 置 循 環 播 放 的 話 就 進 入 該 狀 態 ， 並 且 會 通 過TPLAYER_NOTIFY_PLAYBACK_COMPLETE 這個消息回調給應用。此時能夠調用 TPlayerStart()方法從新從頭播放文件，也能夠 TPlayerStop()中止 TPlayer，或者也能夠 TPlayerSeekTo()來從新定位播放位置。

2.2.9. Error 狀態
因爲某種緣由TPlayer出現了錯誤，就會進入該狀態，而且會經過TPLAYER_NOTIFY_MEDIA_ERROR這個消息回調給應用。若是 TPlayer 進入了 Error 狀態，能夠經過調用 TPlayerReset()來恢復，使得 TPlayer從新返回到 Idle 狀態。

2.2.10. End 狀態
經過 TPlayerDestroy()的方法能夠進入 End 狀態，只要 TPlayer 再也不被使用，就應當儘快將其 destroy掉。

3. 接口函數說明
3.1. TPlayerCreate

3.2.TPlayerDestroy

3.3.TPlayerSetDebugFlag

3.4.TPlayerSetNotifyCallback

3.5.TPlayerSetDataSource

3.6.TPlayerPrepare

3.7.TPlayerPrepareAsync

3.8.TPlayerStart

`````````````

就這些吧，內容有點多的，不想寫了，想看的能夠直接下載資料或到原址（http://bbs.16rd.com/thread-474981-1-1.html）查看