探索视频示例应用程序 - Qualcomm Dragonwing Documentation

您可以通过 Qualcomm IM SDK 框架或使用 V4L2 接口在原生层使用视频功能。Qualcomm 提供基于 GStreamer 和 V4L2 的示例应用程序来运行视频示例用例。

GStreamer 示例

Qualcomm IM SDK 包含用于视频播放的 GStreamer 示例应用程序。注意有关不同 SoC 上支持的 GStreamer 示例应用程序的信息，请参阅多媒体示例应用程序。有关 GStreamer 应用程序先决条件的信息，请参阅运行视频和音频示例应用程序。下表列出了各种方法及相应的示例视频测试用例：

表：测试视频用例的方法

方法	用例
使用 `gst-launch-1.0`	视频播放
	音视频播放
	视频录制
使用 GStreamer 应用程序	视频播放

V4L2 示例

iris_v4l2_test 示例视频测试应用程序使用 Linux V4L2 接口来模拟若干基本的编码器和解码器行为。有关更多信息，请参阅示例 V4L2 应用程序。 Qualcomm Linux 支持以下视频 API：

GStreamer API：Qualcomm GStreamer 插件符合开源 GStreamer 框架。有关基于 GStreamer 的插件的更多信息，请参阅 Qualcomm IM SDK。
V4L2 API：Adreno VPU 驱动遵循符合 V4L2 标准的调用流程。V4L2 API 部分提供与 V4L2 API、命令、控制和事件相关的信息。

配置 GStreamer 和 V4L2 API

Qualcomm 提供可集成到您的媒体管道中的基于 GStreamer 的插件。有关基于 GStreamer 的插件的信息，请参阅配置 Qualcomm GStreamer 插件。
Adreno VPU 驱动使用 V4L2 接口，为所有遵循 V4L2 指导的客户端提供视频编码和解码支持。

GStreamer API

有关 GStreamer 应用程序开发和管道创建的信息，请参阅构建应用程序。

配置 GStreamer API

有关为不同功能及相应插件配置 GStreamer 元素属性的信息，请参阅配置 Qualcomm GStreamer 插件。

V4L2 API

本节介绍解码器和编码器的 V4L2 设备节点、文件操作、命令、控制和事件。

VPU 驱动节点

设备在启动过程中注册 VPU 驱动，并将设备节点号分配给 qcom-multimedia-proprietary-image。

解码器的 VPU 驱动节点：/dev/video32
编码器的 VPU 驱动节点：/dev/video33

注意：

对于 qcom-multimedia-image，VPU 驱动会将设备节点分配给从 video0 到 video27 范围内任意两个设备节点之一。

V4L2 文件操作

Adreno VPU 驱动支持以下 V4L2 文件操作：

表：V4L2 文件操作

操作	描述
`open`	打开视频设备文件描述符（FD），用于通过输入/输出控制 `ioctl` 命令与 VPU 驱动通信
`close`	在视频用例完成后关闭视频设备，并释放与该视频设备相关的所有 VPU 驱动资源
`poll`	等待来自 VPU 驱动的事件
`ioctl`	向 VPU 设备发送命令或控制

解码器和编码器的 V4L2 通用命令

VPU 驱动为视频解码器和编码器用例支持以下 ioctl 命令：

VIDIOC_ENUM_FMT
VIDIOC_TRY_FMT
VIDIOC_G_FMT
VIDIOC_S_FMT
VIDIOC_ENUM_FRAMESIZES
VIDIOC_REQBUFS
VIDIOC_QUERY_BUF
VIDIOC_CREATE_BUF
VIDIOC_PREPARE_BUF
VIDIOC_QBUF
VIDIOC_DQBUF
VIDIOC_STREAMON
VIDIOC_STREAMOFF
VIDIOC_QUERYCAP
VIDIOC_QUERYCTRL
VIDIOC_QUERYMENU
VIDIOC_SUBSCRIBE_EVENT
VIDIOC_UNSUBSCRIBE_EVENT
VIDIOC_G_SELECTION
VIDIOC_G_CTRL
VIDIOC_S_CTRL

V4L2 视频解码器

本节提供有关 Adreno VPU 解码器设备节点、支持的控制、命令和事件的信息。有关打开 VPU 解码器节点的过程，请参阅 VPU 驱动节点。 解码器的 V4L2 ioctl 命令 有关标准 ioctl 命令的描述，请参阅 Video for Linux API 函数参考。除通用命令外，VPU 驱动还为视频解码器用例支持以下 ioctl 命令：

VIDIOC_TRY_DECODER_CMD
VIDIOC_DECODER_CMD

按照内存到内存有状态视频解码器接口中的规定，解码器支持视频解码器用例所需的所有强制命令。 解码器的 V4L2 开源控制 有关标准开源控制的描述，请参阅编解码器控制参考。 VPU 驱动为视频解码器用例支持以下开源控制：

表：解码器的 V4L2 开源控制

控制 ID	用途	动态/静态
`V4L2_CID_MPEG_VIDEO_H264_PROFILE`	H.264 解码器配置文件	静态
`V4L2_CID_MPEG_VIDEO_HEVC_PROFILE`	HEVC 解码器配置文件	静态
`V4L2_CID_MPEG_VIDEO_VP9_PROFILE`	VP9 解码器配置文件	静态
`V4L2_CID_MPEG_VIDEO_H264_LEVEL`	H.264 解码器级别	静态
`V4L2_CID_MPEG_VIDEO_HEVC_LEVEL`	HEVC 解码器级别	静态
`V4L2_CID_MPEG_VIDEO_VP9_LEVEL`	VP9 解码器级别	静态
`V4L2_CID_MPEG_VIDEO_HEVC_TIER`	HEVC 解码器层级	静态

解码器支持以下 V4L2 开源事件：

V4L2_EVENT_EOS
V4L2_EVENT_SOURCE_CHANGE
V4L2_EVENT_CTRL

解码器支持以下 V4L2 命令：

V4L2_DEC_CMD_START
V4L2_DEC_CMD_STOP

V4L2 视频编码器

本节提供有关 Adreno VPU 编码器设备节点、支持的控制、命令和事件的信息。有关打开 VPU 编码器节点的过程，请参阅 VPU 驱动节点。 编码器的 V4L2 ioctl 命令 有关标准 ioctl 命令的描述，请参阅函数参考。除通用命令外，VPU 驱动还为编码用例支持以下 ioctl 命令：

VIDIOC_ENUM_FRAMEINTERVALS
VIDIOC_S_SELECTION
VIDIOC_S_PARM
VIDIOC_G_PARM
VIDIOC_TRY_ENCODER_CMD
VIDIOC_ENCODER_CMD

按照内存到内存有状态视频编码器接口中的规定，编码器支持视频编码器用例所需的所有强制命令。 编码器的 V4L2 开源控制 有关标准开源控制的描述，请参阅编解码器控制参考。 VPU 驱动为视频编码器用例支持以下开源控制：

表：编码器的 V4L2 开源控制

控制 ID	用途	动态/静态
`V4L2_CID_MPEG_VIDEO_H264_PROFILE`	H.264 编码器配置文件	静态
`V4L2_CID_MPEG_VIDEO_HEVC_PROFILE`	HEVC 编码器配置文件	静态
`V4L2_CID_MPEG_VIDEO_H264_LEVEL`	H.264 编码器级别	静态
`V4L2_CID_MPEG_VIDEO_HEVC_LEVEL`	HEVC 编码器级别	静态
`V4L2_CID_MPEG_VIDEO_HEVC_TIER`	H.264 编码器层级	静态
`V4L2_CID_HFLIP`	水平翻转	两者
`V4L2_CID_VFLIP`	垂直翻转	两者
`V4L2_CID_ROTATE`	旋转	静态
`V4L2_CID_MPEG_VIDEO_HEADER_MODE`	头模式	静态
`V4L2_CID_MPEG_VIDEO_PREPEND_SPSPPS_TO_IDR`	带即时解码器刷新（IDR）帧的 SPS/PPS	静态
`V4L2_CID_MPEG_VIDEO_FORCE_KEY_FRAME`	请求强制同步帧	两者
`V4L2_CID_MPEG_VIDEO_BITRATE`	平均比特率	两者
`V4L2_CID_MPEG_VIDEO_BITRATE_PEAK`	峰值比特率	两者
`V4L2_CID_MPEG_VIDEO_BITRATE_MODE`	码率控制	静态
`V4L2_CID_MPEG_VIDEO_FRAME_SKIP_MODE`	跳帧模式	静态
`V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE`	启用/禁用码率控制（RC）	静态
`V4L2_CID_MPEG_VIDEO_GOP_SIZE`	图像组（GOP）大小	两者
`V4L2_CID_MPEG_VIDEO_B_FRAMES`	B 帧	静态
`V4L2_CID_MPEG_VIDEO_LTR_COUNT`	LTR 帧数	静态
`V4L2_CID_MPEG_VIDEO_USE_LTR_FRAMES`	使用 LTR	两者
`V4L2_CID_MPEG_VIDEO_FRAME_LTR_INDEX`	标记 LTR	两者
`V4L2_CID_MPEG_VIDEO_BASELAYER_PRIORITY_ID`	为分层编码设置基础层 ID	静态
`V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE`	帧内刷新	静态
`V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD`	帧内刷新周期	两者
`V4L2_CID_MPEG_VIDEO_H264_MIN_QP`	H.264 最小量化参数（QP）	静态
`V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP`	HEVC 最小 QP	静态
`V4L2_CID_MPEG_VIDEO_H264_MAX_QP`	H.264 最大 QP	静态
`V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP`	HEVC 最大 QP	静态
`V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MIN_QP`	H.264 I 帧最小 QP	静态
`V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MIN_QP`	HEVC I 帧最小 QP	静态
`V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MIN_QP`	H.264 P 帧最小 QP	静态
`V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MIN_QP`	HEVC P 帧最小 QP	静态
`V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MIN_QP`	H.264 B 帧最小 QP	静态
`V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MIN_QP`	HEVC B 帧最小 QP	静态
`V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MAX_QP`	H.264 I 帧最大 QP	静态
`V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MAX_QP`	HEVC I 帧最大 QP	静态
`V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MAX_QP`	H.264 P 帧最大 QP	静态
`V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MAX_QP`	HEVC P 帧最大 QP	静态
`V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MAX_QP`	H.264 B 帧最大 QP	静态
`V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MAX_QP`	HEVC B 帧最大 QP	静态
`V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_QP`	HEVC I 帧 QP	两者
`V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP`	H.264 I 帧 QP	两者
`V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_QP`	HEVC P 帧 QP	两者
`V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP`	H.264 P 帧 QP	两者
`V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_QP`	HEVC B 帧 QP	两者
`V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP`	H.264 B 帧 QP	两者
`V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_TYPE`	HEVC 分层编码类型	静态
`V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_TYPE`	H.264 分层编码类型	静态
`V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING`	H.264 分层编码	静态
`V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_LAYER`	HEVC 分层层数	两者
`V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER`	H.264 分层层数	两者
`V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L0_BR`	H.264 层 0 比特率	两者
`V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L0_BR`	HEVC 层 0 比特率	两者
`V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L1_BR`	H.264 层 1 比特率	两者
`V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L1_BR`	HEVC 层 1 比特率	两者
`V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L2_BR`	H.264 层 2 比特率	两者
`V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L2_BR`	HEVC 层 2 比特率	两者
`V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L3_BR`	H.264 层 3 比特率	两者
`V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L3_BR`	HEVC 层 3 比特率	两者
`V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L4_BR`	H.264 层 4 比特率	两者
`V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L4_BR`	HEVC 层 4 比特率	两者
`V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L5_BR`	H.264 层 5 比特率	两者
`V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L5_BR`	HEVC 层 5 比特率	两者
`V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE`	H.264 熵编码模式	静态
`V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE`	编码切片模式	静态
`V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_BYTES`	切片中的最大字节数	静态
`V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB`	切片中的最大宏块数	静态

请在两个平面上都设置好格式之后、在任一平面上请求缓冲区之前，设置所有静态配置选项。在两个平面上设置好格式之后再调用动态参数。有关编码器 V4L2 控制的信息，请参阅编解码器控制参考。编码器支持的开源事件包括：

V4L2_EVENT_EOS
V4L2_EVENT_CTRL

编码器支持的开源命令包括：

V4L2_ENC_CMD_START
V4L2_ENC_CMD_STOP

配置 V4L2 API

使用本节提供的 V4L2 控制 ID、接受的格式、接受的范围和示例代码信息，在您的设备上配置和管理不同的视频功能。 B 帧编码 您可以使用 VIDIOC_S_CTRL ioctl 系统调用配置 VPU 驱动，在编码器会话中设置 B 帧。请在输出平面上设置 VIDIOC_STREAMON 之前设置 B 帧编码配置。VPU 驱动仅在使用分层编码时支持 B 帧编码。此功能不支持动态配置。

表：B 帧编码的控制 ID

H.264 和 HEVC 编解码器的控制 ID	接受的格式	范围
`V4L2_CID_MPEG_VIDEO_B_FRAMES`	整数	0：禁用 B 帧 1：启用单个 B 帧

以下代码示例显示单个 B 帧的静态配置：

v4l2_control control;
int ret = 0;
int bframes = 1;
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_B_FRAMES;
control.value = bframes;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_TYPE;
control.value = 0;// V4L2_MPEG_VIDEO_HEVC_HIERARCHICAL_CODING_B
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER;
control.value = 1;//Enable 1 layer
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}

编码器初始 QP 覆盖 您可以配置 VPU 驱动，将 I 帧、P 帧和 B 帧的初始帧量化参数（QP）覆盖为编码帧的预期值。您可以使用 VIDIOC_S_CTRL ioctl 系统调用进行覆盖。QP 覆盖提供了灵活性，可以仅为 I 帧、仅为 P 帧、仅为 B 帧、仅为 I 帧和 P 帧、仅为 P 帧和 B 帧或这些帧的组合设置初始帧 QP。请在输出平面上执行 VIDIOC_STREAMON 之前设置编码器初始 QP 覆盖配置，且该配置仅适用于编码器会话。

表：编码器初始 QP 覆盖的控制 ID

H.264 编解码器的控制 ID	接受的格式	QP 范围
`V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP`	整数	根据编解码器标准的示例： 8 位为 1 到 51 10 位为 1 到 63（-12 到 51）
`V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP`	整数
`V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP`	整数
HEVC 编解码器的控制 ID	接受的格式	QP 范围
`V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_QP`	整数	根据编解码器标准的示例： 8 位为 1 到 51 10 位为 1 到 63（-12 到 51）
`V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_QPI`	整数
`V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_QP`	整数

以下代码示例显示要设置的静态配置参数：

将 40 作为 I 帧的初始 QP
将 35 作为 P 帧的初始 QP
H.264 会话的 B 帧

v4l2_control control;
int ret = 0;
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP;
control.value = 40;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP;
control.value = 35;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP;
control.value = 35;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}

切片编码 您可以使用 VIDIOC_S_CTRL ioctl 系统调用配置 VPU 驱动，将单个帧编码为多个切片。每个切片的位数或每个切片的宏块数即为切片边界。请在输出平面上执行 VIDIOC_STREAMON 之前设置切片编码配置。切片编码功能不支持动态配置，且该配置仅适用于编码器会话。

表：切片编码的控制 ID

H.264 和 HEVC 编解码器的控制 ID	接受的格式	范围
`V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE`	枚举	`v4l2_mpeg_video_multi_slice_mode` 根据编解码器标准的值： enum `v4l2_mpeg_video_multi_slice_mode`
`V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_BYTES`	整数	512 - MAX_BITRATE/8 单位：位/秒
`V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB`	整数	1 到 36864 单位：宏块

以下代码示例显示将帧编码为多个切片、且每个切片的最大宏块数设置为 400 的静态配置：

v4l2_control control;
int ret = 0;
v4l2_mpeg_video_multi_slice_mode slicemode = V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_MB;
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE;
control.value = slicemode;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB;
control.value = 400;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}

帧内刷新 您可以使用 VIDIOC_S_CTRL ioctl 系统调用配置 VPU 驱动以激活帧内刷新模式和帧内刷新周期。请在输出平面上发出 VIDIOC_STREAMON 之前设置帧内刷新配置。您可以在会话期间动态更改帧内刷新周期，此功能仅适用于编码器会话。

表：帧内刷新的控制 ID

H.264 和 HEVC 编解码器的控制 ID	接受的格式	范围
`V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE`	enum `v4l2_mpeg_video_intra_refresh_period_type`	Random mode: `V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE_RANDOM` Cyclic mode: `V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE_CYCLIC`
`V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD`	整数	将帧内刷新周期设置为小于 I 帧间隔单位：帧数

以下代码示例显示每 10 帧激活一次随机帧内刷新的静态配置：

v4l2_control control;
int ret = 0;
v4l2_mpeg_video_intra_refresh_period_type refreshtype = V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE_RANDOM;

memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE;
control.value = refreshtype;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD;
control.value = 10;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}

旋转您可以使用 VIDIOC_S_CTRL ioctl 系统调用配置 VPU 驱动，在编码前旋转输入帧。请在输出平面上执行 VIDIOC_STREAMON 之前设置旋转配置。旋转功能不支持动态配置，且仅适用于编码器会话。

表：旋转的控制 ID

H.264 和 HEVC 编解码器的控制 ID	接受的格式	范围
`V4L2_CID_ROTATE`	整数	单位：度

以下代码示例显示将输入帧旋转 90 度的静态配置：

v4l2_control control;
int ret = 0;
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_ROTATE;
control.value = 90;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}

帧 QP 范围 您可以使用 VIDIOC_S_CTRL ioctl 系统调用配置 VPU 驱动，将 I 帧、P 帧和 B 帧的最小和最大帧 QP 范围参数设置为编码帧的预期值。请在输出平面上执行 VIDIOC_STREAMON 之前设置帧 QP 范围配置。这些值在整个会话中有效。不支持动态配置，且帧 QP 功能仅适用于编码器会话。

表：帧 QP 范围的控制 ID

H.264 编解码器的控制 ID	接受的格式	范围
`V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MIN_QP`	整数	根据编解码器标准的示例：8 位为 1 到 51
`V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MAX_QP`
`V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MIN_QP`
`V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MAX_QP`
`V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MIN_QP`
`V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MAX_QP`
`V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MIN_QP`
`V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MAX_QP`
`V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MIN_QP`
`V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MAX_QP`
`V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MIN_QP`
`V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MAX_QP`

以下代码示例显示在 H.264 会话中为 I 帧、P 帧和 B 帧选择 40 作为最大 QP、10 作为最小 QP 的静态配置参数：

v4l2_control control;
int ret = 0;
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MIN_QP;
control.value = 10;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MIN_QP;
control.value = 10;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MIN_QP;
control.value = 10;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MAX_QP;
control.value = 40;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MAX_QP;
control.value = 40;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}
memset(&control, 0, sizeof(control));
control.id = V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MAX_QP;
control.value = 40;
ret = ioctl(mDriverFd, VIDIOC_S_CTRL, &control);// mDriverFd returned from open() system call
if (ret) {
    return -1;
}

如果您需要为 I 帧、P 帧和 B 帧设置相同的最小和最大 QP 值，可以配置以下控制： 表：H.264 编解码器的控制 ID

表：H.264 编解码器的控制 ID

H.264 编解码器的控制 ID	接受的格式	范围
`V4L2_CID_MPEG_VIDEO_H264_MIN_QP`	整数	根据编码标准的示例：8 位为 1 到 51
`V4L2_CID_MPEG_VIDEO_H264_MAX_QP`	整数	根据编码标准的示例：8 位为 1 到 51

表：HEVC 编解码器的控制 ID

HEVC 编解码器的控制 ID	接受的格式	范围
`V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP`	整数	根据编码标准的示例：8 位为 1 到 51
`V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP`	整数	根据编码标准的示例：8 位为 1 到 51

​GStreamer 示例

​V4L2 示例

​配置 GStreamer 和 V4L2 API

​GStreamer API

​配置 GStreamer API

​V4L2 API

​VPU 驱动节点

​V4L2 文件操作

​解码器和编码器的 V4L2 通用命令

​V4L2 视频解码器

​V4L2 视频编码器

​配置 V4L2 API

​后续步骤