基于C++的轻量级播放器

约定不等于承诺〃 2024-02-20 10:19 60阅读 0赞

[资源下载地址][Link 1]：https://download.csdn.net/download/sheziqiong/88483389  
[资源下载地址][Link 1]：https://download.csdn.net/download/sheziqiong/88483389

## 轻量级播放器 ##

![92f7a3238a3ab88ef856c590ca7e8a2c.png][]

### 简介 ###

TinyPot 是一个轻量级播放器。

该播放器的前身是金庸水浒传的片头动画播放子程。在整个游戏过程中该子程仅被调用了一次，但是为了做好这个部分，开发组使用了 FFmpeg 进行解码，BASS 进行播放，SDL2 进行输出，并成功将其移植到了其他平台。因此，金庸水浒传的片头实际支持相当多的格式。而大水壶播放器在设计阶段，也是使用类似的架构，但是在开发阶段发现音频难以控制，因此改为了使用 SDL2 播放。

而水浒的谐音是水壶，同时新论坛叫大武侠，有个“大”字，所以该播放器起名“大水壶”，英文 BigPot。至于跟著名的播放器 PotPlayer 有没有关系，答案是一点都没有，而且 PotPlayer 的功能远远强于大水壶，名字有点像只是巧合。

另外现在改叫小水壶了……

### 架构 ###

程序语言是 C++，使用 FFmpeg 进行解码，SDL2 硬件输出，还有 SDL\_image、SDL\_ttf 等库。字幕部分使用 libass，该库又依赖 Fontconfig、freetype 和 fribidi。配置文件使用的是 tinyxml2，hash 是 sha3。

该播放器的架构并未参考其他主流播放器，而是重新设计的单线程预解，原理如下图。在跳转的时候可能会稍慢于其他的主流播放器，但是相差并不明显。

![71ce49239a1097e6ae4a6b3bbbd8811e.png][]

### 编译 ###

首先需要取得 common 库。

git clone https://github.com/scarsty/common common

其余依赖库包括 iconv，FFmpeg，libass，SDL2，SDL2-image，SDL2-ttf 等，推荐使用系统的包管理工具获取这些库，Windows 下推荐使用 vcpkg。其中 SDL2\_image 仅有一处使用，且并不是必须的，可以简单修改后去除。

Windows 下也可以从 [https://github.com/scarsty/lib-collection][https_github.com_scarsty_lib-collection] 取得头文件和导入库。

[https://github.com/AutoItConsulting/text-encoding-detect][https_github.com_AutoItConsulting_text-encoding-detect]、sha3、tinyxml2，均直接包含代码到工程中。

#### Windows ####

请使用 Visual Studio 2017 编译 x64 版。

32 位部分默认编译为 dll，可以嵌入其他程序的窗口播放。特别是基于 SDL2 的游戏，用法非常简单。

#### Macosx ####

推荐使用 homebrew 安装依赖库。

使用 CMake 生成 Makefile。

脚本 a.sh 可以自动编译和处理动态库的依赖修正。

#### Linux ####

与上面方法类似，但是通常不需要打包为 app，因此比 Mac 要简单。

#### 单文件版 ####

如果需要编译单文件（全静态链接）版，导入库比动态链接版要多出很多，建议使用 vcpkg 之类解决（vcpkg 生成的 fribidi 静态库不正确，需手动修正）。

以下为参考（fribidi 及以下是动态链接不需要的）：

sdl2.lib
    sdl2_ttf.lib
    sdl2_image.lib
    sdl2main.lib
    ass.lib
    libiconv.lib
    avutil.lib
    avcodec.lib
    avformat.lib
    swresample.lib
    swscale.lib
    fribidi.lib
    harfbuzz.lib
    freetype.lib
    bz2.lib
    libpng16.lib
    zlib.lib
    libcharset.lib
    winmm.lib
    version.lib
    imm32.lib
    bcrypt.lib
    secur32.lib
    ws2_32.Lib

若是需要编译 dll 文件，用于在其他基于 SDL2 的游戏中播放视频时，则 TinyPot 和游戏均不应静态链接 SDL。因为 SDL 的动态库中含有全局变量，多次静态链接后该变量会有多个副本，其中一个很可能是不正确的。

### 使用方法 ###

因为没有制作配置的图形界面，所以仅能将文件拖到图标或者窗口上进行播放，或者设置为文件类型默认的打开方式。

#### 支持的格式 ####

FFmpeg 能解什么格式它就能放什么格式，FFmpeg 不能解的，它也放不出来。而且也不考虑调用其他的解码器，因为作者不会。

特别地，不能播放 WAV，以及 WAV 为音频流的视频文件，因为 WAV 是没有压缩的，谈不上解码。也不推荐用它播放纯音频，因为它的音频没有经过处理，只是把解码的结果原样放出来，远不及专门的播放器。

#### 字幕 ####

打开文件的时候，会先判断有没有字幕，有的话会自动载入。或者播放的时候拖一个字幕进去也会载入字幕，而字幕的扩展名必须是 ass、ssa、srt、txt 其中之一。其他文件都会当成媒体文件处理，能否播放看解码器的。

查找字幕的方式是先依次将媒体文件的扩展名替换为 ass、ssa、srt，并在媒体所在目录下以及 sub 子目录中寻找，即可以将字幕集中放到 sub 子目录。

#### 功能键 ####

<table> 
 <thead> 
  <tr> 
   <th>按键</th> 
   <th>功能</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>方向左右</td> 
   <td>跳过几秒</td> 
  </tr> 
  <tr> 
   <td>方向上下，鼠标滚轮</td> 
   <td>音量</td> 
  </tr> 
  <tr> 
   <td>空格</td> 
   <td>暂停</td> 
  </tr> 
  <tr> 
   <td>回车</td> 
   <td>全屏切换</td> 
  </tr> 
  <tr> 
   <td>退格</td> 
   <td>回到视频开头</td> 
  </tr> 
  <tr> 
   <td>Delete</td> 
   <td>删除播放记录</td> 
  </tr> 
  <tr> 
   <td>1</td> 
   <td>切换音频流</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>切换字幕流</td> 
  </tr> 
  <tr> 
   <td>,(&lt;)</td> 
   <td>上一个文件</td> 
  </tr> 
  <tr> 
   <td>.(&gt;)</td> 
   <td>下一个文件</td> 
  </tr> 
  <tr> 
   <td>0</td> 
   <td>窗口大小调整为视频尺寸</td> 
  </tr> 
  <tr> 
   <td>-</td> 
   <td>减小窗口</td> 
  </tr> 
  <tr> 
   <td>=(+)</td> 
   <td>增大窗口</td> 
  </tr> 
 </tbody> 
</table>

#### XML 中的设置 ####

<table> 
 <thead> 
  <tr> 
   <th>设置</th> 
   <th>功能</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>volume</td> 
   <td>音量</td> 
  </tr> 
  <tr> 
   <td>auto_play_recent</td> 
   <td>自动播放上次关闭时的文件</td> 
  </tr> 
  <tr> 
   <td>record_name</td> 
   <td>是否记录文件名</td> 
  </tr> 
  <tr> 
   <td>sys_encode</td> 
   <td>系统字串编码</td> 
  </tr> 
  <tr> 
   <td>ui_font</td> 
   <td>显示界面的字体</td> 
  </tr> 
  <tr> 
   <td>sub_font</td> 
   <td>显示字幕的默认字体</td> 
  </tr> 
 </tbody> 
</table>

### 遗留问题 ###

因为是单线程架构，所以在一些文件跳转时会出现马赛克。一般来说这个可以通过清除解码器状态来解决，但是单线程架构下这个操作会导致后面一帧的解码卡顿，故没有这么做。

通常 RM 和 RMVB，以及从流媒体服务器直接下载的 MP4 可能有此问题。

### 预编译版下载 ###

[https://github.com/scarsty/tinypot/releases/tag/download][https_github.com_scarsty_tinypot_releases_tag_download]

### 播放效果 ###

![9a410e4d9757952c4bb4461832d647da.png][]  
[资源下载地址][Link 1]：https://download.csdn.net/download/sheziqiong/88483389  
[资源下载地址][Link 1]：https://download.csdn.net/download/sheziqiong/88483389

[Link 1]: https://download.csdn.net/download/sheziqiong/88483389
[92f7a3238a3ab88ef856c590ca7e8a2c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/184bdeea06fc45399e9bfaf89da413b8.png
[71ce49239a1097e6ae4a6b3bbbd8811e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/5037c7f1fc4f42f88af16b864cb4b872.png
[https_github.com_scarsty_lib-collection]: https://github.com/scarsty/lib-collection
[https_github.com_AutoItConsulting_text-encoding-detect]: https://github.com/AutoItConsulting/text-encoding-detect
[https_github.com_scarsty_tinypot_releases_tag_download]: https://github.com/scarsty/tinypot/releases/tag/download
[9a410e4d9757952c4bb4461832d647da.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/70bcd20cf320474a80896498703cd56d.png