参考文献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 | 视频区域操作鼠标或者视频区域拥有焦点时操作键盘时触发,两个小项目中都在此事件中处理鼠标操作,包括左键、右键、双击等 |
cpp
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