参考文献1除了介绍Aplayer组件的用法之外，还提供有demo下载以供学习，本文学习并记录其中的使用方式。
VideoPlayer项目使用C#在VS2013开发，其解决方案中包括VideoPlayer和VideoPlayer两个小项目，前者基于.net framework4.0，后者基于.net framework3.5，这两个项目的程序截图如下所示：
上述界面，基本都采用的基于Aplayer控件构建播放界面的技术路线，支持打开本地视频、在线视频（试了输入B网的视频地址，打不开，不清楚是不是视频地址格式不对造成的）、音量调节、播放/暂停/停止等功能，程序都不算复杂。
项目中主要调用APlayer控件的以下主要函数：
| 序号 | 名称 | 说明 |
|---|---|---|
| 1 | SetVolume | 设置播放音量，取值范围为 0 - 1000 |
| 2 | SetCustomLogo | 设置视频区域在未播放视频时显示的图片 |
| 3 | GetDuration | 获取视频时长，单位为毫秒 |
| 4 | Open | 打开并播放视频文件，可以是本地或局域网或网络文件、DVD光碟、USB摄像头、屏幕或另一窗口截图 ， Open 函数是一个异步方法, 调用后立即返回, 调用者想要知道 APlayer 是否真正成功地打开了媒体文件, 需要等后续的事件回调，如果打开成功，调用者会收到 OnOpenSucceeded 事件，如果打开失败，APlayer 的播放状态会变成 PS_READY 状态 |
| 5 | GetState | 获取播放引擎当前状态，返回值在下面的PLAY_STATE中定义 |
| 6 | Pause | 暂停视频 |
| 7 | Play | 继续播放视频 |
| 8 | Close | 关闭视频 |
| 9 | SetPosition | 设置视频播放位置，单位为毫秒，会触发OnSeekCompleted 事件 |
| 10 | GetPosition | 获取视频播放位置，单位为毫秒 |
| 11 | SetConfig | 设置播放参数，参数详细说明见APlayerSDK帮助文档中的APlayer设置 |
项目中主要处理APlayer控件的以下几类事件：
| 序号 | 名称 | 说明 |
|---|---|---|
| 1 | OnBuffer | 播放在线视频，从网络缓冲媒体数据过程中触发，能够从事件中获取到缓冲百分比，100%时即可播放 |
| 2 | OnStateChanged | 迅雷播放引擎状态变化时触发，一般在播放、暂停、停止时触发，详细的状态说明见下面的枚举定义 |
| 3 | OnSeekCompleted | 跳转到指定位置时播放，主要是调用SetPosition函数设置播放位置后触发，能在事件中获取到最新的播放位置 |
| 4 | OnOpenSucceeded | 成功打开视频文件时触发，根据帮助文档，在此事件中可以做一些播放前的初始化工作 |
| 5 | OnDownloadCodec | 播放视频文件缺少对应的解码器时触发，能在事件中获取缺少的解码器的全路径，可以通过程序同步或异步下载解码器文件 |
| 6 | OnMessage | 视频区域操作鼠标或者视频区域拥有焦点时操作键盘时触发，两个小项目中都在此事件中处理鼠标操作，包括左键、右键、双击等 |
enum PLAY_STATE
{
PS_READY = 0, // 准备就绪
PS_OPENING = 1, // 正在打开
PS_PAUSING = 2, // 正在暂停
PS_PAUSED = 3, // 暂停中
PS_PLAYING = 4, // 正在开始播放
PS_PLAY = 5, // 播放中
PS_CLOSING = 6, // 正在开始关闭
};
项目编译完成后，会在可执行文件所在目录下创建codecs，需要手动将解码器文件复制到该文件夹内才可正常播放视频，上一篇文章中最后提到的问题就是没有复制解码器文件造成的（也可以调用SetConfig函数通过Codecs path参数设置解码器文件路径），后续会参照本文学习的源码编写简单的视频播放程序。
参考文献：
[1]https://blog.csdn.net/qq_45533937/article/details/115800927
![[论文笔记]BGE](https://img-blog.csdnimg.cn/img_convert/b1719d974e103a39ca7e66ff844f21f4.png)
