全志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）查看