Windows/linux版本中QSV 在 FFMPEG 中的使用教程

qsv是一种视频加速格式。qsv格式是爱奇艺公司研发的一种视频文件格式，由于爱奇艺全面正版视频，故qsv格式只能使用奇艺播放器（爱奇艺影音）播放

QSV 在 FFMPEG 中的使用（windows）

INDE

在 Windows 下通常使用 INDE 中的 Intel Media SDK 而不是 MMS，因为后者只在 Linux 下和 Windows Server 下可用。

INDE 可以免费下载，建议下载它的离线安装包，因为很多功能你并不需要，使用离线安装包，你可以指下载你想要的功能。

安装 Media SDK

在 Windows 上安装 Media SDK 比较简单，请参考这个链接中的安装方法。我们只使用它做视频编码，所以只需要选择build 下的

- Media SDK for Windows
- Media Raw Acclecerator for Windows
这两项就可以了。

Windows 下编译支持 qsv 的 FFMPEG 库

编译 mfx_dispatcher

windows 编译 qsv 之前需要安装 mfx_dispatcher，它相当于是应用程序和具体的硬件加速库之间的一个中间层，它负责帮助应用库定位底层代码，这样应用库就可以不用直接链接到硬件加速的具体实现。

[mfx_dispatcher][] 代码可以在 github 上下载到，在 github 的 README 中也提供了编译方法。需要注意的是，它使用的编译工具是 mingw64 的 x86_64 工具链，如果你使用的是 mingw64 的 i686 工具库，记得把教程中的 x86_64替换成 i686。

mfx_dispatcher 安装完成之后会在 /usr/i686-w64-mingw32/usr/local/ 下生成相应的库文件和头文件。

链接到 FFMPEG

FFMPEG 需要使用 pkg-config 定位 libmfx 库，这个库的 libmfx.pc 文件在安装完 mfx_dispatcher 之后会安装在/usr/i686-w64-mingw32/usr/local/lib/pkgconfig 目录下。为了让 FFMPEG 的configure 脚本能够找到它你需要把这个地址加入到 PKG_CONFIG_PATH 中。

export PKG_CONFIG_PATH=/usr/i686-w64-mingw32/usr/local/lib/pkgconfig
为了让 FFMPEG 支持 qsv 你需要加入下面三个配置选项：

./configure --enable-libmfx
            --enable-encoder=h264_qsv
            --enable-decoder=h264_qsv
            ...
使用中可能会出现的问题

在使用 h264_qsv 编码器的时候，可能会出现 Error initializing an internal MFX session 错误，目前没有找到具体原因。在把 Media SDK 下的libmfxhw32.dll 文件拷贝到执行目录下之后这个问题就消失看。

QSV 在 FFMPEG 中的使用（Linux）

Intel Media SDK

现在 Intel 不再发布单独的 Intel Media SDK， 这个组件在 Linux 平台下集成在 Intel Media Server Studio 中，后文简称 MMS

目前的 MMS 版本推荐的安装平台只有一个 CentOS（SUSE12 在当前版本中也算是一个推荐平台）。其他平台的安装比较复杂，官方也不太推荐使用。后文的介绍是基于 CentOS 操作系统的。

如何安装 MMS

首先，你需要在 Intel Developer Zone 下载最新的 MMS 版本，其中的 Community 版本是免费的， MMS 的安装主要分三个步骤。

在解压出来的的文件夹下面有一个 SDK2015Production* 目录，切换到这个目录下面之后，有一个 CentOS 目录。这个目录下面有一个 intel_scripts_centos*压缩包，解压这个压缩包之后可以得到下面三个脚本：

-build_kernel_rpm_CentOS.sh
-install_sdk_UMD_CentOS.sh
-uninstall_sdk_UMD_CentOS.sh
安装需要用的是前面两个脚本。

1. 安卓用户空间驱动（user-mode driver – UMD）

下面的命令需要使用超级用户权限：

./install_sdk_UMD_CentOS.sh

mkdir /MSS

chown {普通用户名}:{普通组名} /MSS
2. 编译内核空间的驱动包

下面的命令使用普通用户权限执行：

cp build_kernel_rpm_CentOS.sh /MSS

cd /MSS

./build_kernel_rpm*.sh
3. 安装内核空间的驱动

下面的命令使用超级用户权限执行：

cd /MSS/rpmbuild/RPMS/x86_64

rpm -Uvh kernel-3.10.*.rpm

reboot
判断是否已经成功的编译内核模块驱动

重启系统之后执行如下命令：

lsmod | grep 'i915'
得到的类似如下的结果：

i915                837369 4
drm_kms_helper      44256 1 i915
drm                 294746 3 i915,drm_kms_helper
i2c_algo_bit        13509 1 i915
intel_gtt           19747 1 i915
i2c_core            40683 5
i2c_i801,i915,drm_kms_helper,drm,i2c_algo_bit
video               19785 1 i915
button              13953 1 i915
如何在 FFMPEG 中编译 intel qsv 硬件编码器

FFMPEG 中使用 libmfx 实现 intel qsv 的硬件编码器，如果想要编译它的硬件编码器，所以如果想要编译这个硬件编码器，你需要在加入如下的配置选项：

./configure --enable-libmfx
            --enable-encoder=h264_qsv
            --enable-decoder=h264_qsv
            ...
libmfx can not found using pkg-config

libmfx.pc

编译中可能会报出下面的错误： libmfx can not found using pkg-config，这个错误可能是不同的原因导致，你需要查看 ffmpeg 根目录下的 config.log 文件。

如果这个文件中报错说 pkg-config 无法找到 libmfx 这个库，那是因为 MMS 的默认安装没有提供 libmfx.pc 文件，你需要在自己创建这个文件：

sudo mkdir -p /opt/intel/mediasdk/pkgconfig

vim /opt/intel/mediasdk/lib64/pkgconfig/libmfx.pc
在文件中写入如下内容：

prefix=/opt/intel/mediasdk
exec_prefix=${prefix}
libdir=${exec_prefix}/lib64
includedir=${exec_prefix}/include

Name: libmfxhw64

Description: Intel Media SDK dispatcher.

Version: 2015r6
Libs: -L${libdir} -lmfxhw64
Cflags: -I${includedir}
注意这个地方引用的是 libmfxhw64 库，因为测试的是 64 位平台。

当然你可以可以选择在 /usr/lib64/pkgconfig/ 下面创建 libmfx.pc 文件。

mfx/mfxvideo.h

同样是 libmfx can not found using pkg-config 这个命令，也可能是头文件的错误，在 config.log 中会报错说无法找到 mfx/mfxvideo.h 这个文件。

在安装完 MMS 之后，在 /opt/intel/mediasdk/include/ 目录下面会有mfxvideo.h 这个文件，但是在 FFMPEG 中，引用的是 mfx/mfxvideo.h 这个头文件，因此报错，解决的方式是，在 /opt/intel/mediasdk/include 这个目录下面新建目录 mfx，然后吧 include 的头文件拷贝一份到 mfx 目录下。

通过上面这种方式可以修正 mfx/mfxvideo.h 无法找到的错误。

链接 FFMPEG 时的错误

在链接 ffmpeg 的时候还是有可能会出现 MFXxxx undefinded reference 的错误，这时候你需要让你的程序链接到 lmfxhw64 这个库。最简单的方式是，在/usr/lib64/ 中建立一个 libmfxhw64 的软连接

ln -s /opt/intel/mediasdk/lib64/libmfxhw64.so /usr/lib64/libmfxhw64.so
然后在编译自己的程序的时候加入 -lmfxhw64 选项。

在 FFMPEG 中使用 qsv 编码器

qsv 的编码器在 FFMPEG 中有 h264 和 h265 两种，你可以通过下面的代码找到这个编码器。

av_find_encoder_by_name("h264_qsv");
此外，通过 qsvenc_h264.c 这个源文件，我们可以看到它支持 QSV 和 NV12两种格式，但是 QSV 这个格式好像无法正常的使用，你需要把编码的 pfx_fmt设置成 NV12。