# v4l2h264enc Source: [https://docs.qualcomm.com/doc/80-70017-50SC/topic/v4l2h264enc.html](https://docs.qualcomm.com/doc/80-70017-50SC/topic/v4l2h264enc.html) v4l2h264enc 插件使用 V4L2 API 对视频流进行编码。 - 该插件使用 H.264 视频编码器在支持的平台上提供硬件加速的 H.264 (MPEG-4 第 10 部分) 编码。 - 该插件基于[GstVideoEncoder](https://gstreamer.freedesktop.org/documentation/video/gstvideoencoder.html?gi-language=c)基类。 ## 继承链 [GObject](https://docs.gtk.org/gobject/) → [GstObject](https://gstreamer.freedesktop.org/documentation/gstreamer/gstobject.html?gi-language=c) → [GstElement](https://gstreamer.freedesktop.org/documentation/gstreamer/gstelement.html?gi-language=c) → [GstVideoEncoder](https://gstreamer.freedesktop.org/documentation/video/gstvideoencoder.html?gi-language=c) → GstV4l2VideoEnc → v4l2h264enc 下表提供了有关 v4l2h264enc 的端口模板和组件属性的信息。有关用例信息，请参见[视频编码](https://docs.qualcomm.com/doc/80-70017-50SC/topic/camera-and-video-encode.html)和[基于切片的编码](https://docs.qualcomm.com/doc/80-70017-50SC/topic/camera-and-video-encode.html#slice-based-encoding)。 ## 端口配置 | 端口名称 | 功能 | 功能 | 功能 | | --- | --- | --- | --- | | SINK 模板：'sink'
| video/x-raw | format： | { (string)NV12, (string)NV21 } | | SINK 模板：'sink'
| video/x-raw | width: | [ 1, 32768 ] | | SINK 模板：'sink'
| video/x-raw | height: | [ 1, 32768 ] | | SINK 模板：'sink'
| video/x-raw | framerate： | [ 0/1, 2147483647/1 ] | | SRC 模板：'src'
| video/x-h264 | alignment: | au | | SRC 模板：'src'
| video/x-h264 | stream-format: | byte-stream | | SRC 模板：'src'
| video/x-h264 | level: | { (string)1, (string)1b, (string)1.1, (string)1.2, (string)1.3, (string)2, (string)2.1, (string)2.2, (string)3, (string)3.1, (string)3.2, (string)4, (string)4.1, (string)4.2, (string)5, (string)5.1 } | | SRC 模板：'src'
| video/x-h264 | profile: | { (string)baseline, (string)constrained-baseline, (string)main, (string)high, (string)constrained-high } | | | | | | | | | | | | | | | | ## 组件配置 Table : v4l2h264enc 的组件属性 | 属性 | 说明 | | --- | --- | | capture-io-mode | 采集 I/O 模式（匹配发送端）
| | device | 设备位置
| | device-fd | 设备的文件描述符
| | device-name | 设备名称
| | extra-controls | 设备的额外 v4l2 控件 ID (CID)
| | min-force-key-unit-interval | force-key-unit 请求之间的最小间隔（单位：纳秒）
| | name | 对象名称
| | output-io-mode | 输出侧 I/O 模式（匹配接收端）
| | parent | 对象的父级
| | qos | 处理下游的服务质量事件
| Table : v4l2ctl extra-controls – 用户控件 | 控件名称 | 控件类型 | 参数 | | --- | --- | --- | | horizontal\_flip | Boolean | | | vertical\_flip | Boolean | | | rotate | 整型 | | Table : v4l2ctl extra-controls – 编解码控件 | 控件名称 | 控件类型 | 参数 | | --- | --- | --- | | video\_b\_frames | 整型 | | | video\_gop\_size | 整型 | | | video\_bitrate\_mode | 菜单 | | | video\_bitrate | 整型 | | | frame\_level\_rate\_control\_enable | 整型 | | | maximum\_bytes\_in\_a\_slice | 整型 | | | number\_of\_mbs\_in\_a\_slice | 整型 | | | slice\_partitioning\_method | 菜单 | | | ltr\_count | 整型 | | | frame\_ltr\_index | 整型 | | | use\_ltr\_frames | 位掩码 | | | intra\_refresh\_period | 整型 | | | intra\_refresh\_period\_type | 菜单 | | Table : v4l2ctl extra-controls – H.264 codec 控件 | 控件名称 | 控件类型 | 参数 | | --- | --- | --- | | h264\_i\_frame\_qp\_value | 整型 | | | h264\_p\_frame\_qp\_value | 整型 | | | h264\_b\_frame\_qp\_value | 整型 | | | h264\_minimum\_qp\_value | 整型 | | | h264\_maximum\_qp\_value | 整型 | | | h264\_entropy\_mode | 菜单 | | | h264\_level | 菜单 | | | h264\_profile | 菜单 | | | enable\_h264\_hierarchical\_coding | 整型 | | | h264\_hierarchical\_coding\_type | 菜单 | | | h264\_number\_of\_hc\_layers | 整型 | | | h264\_i\_frame\_minimum\_qp\_value | 整型 | | | h264\_i\_frame\_maximum\_qp\_value | 整型 | | | h264\_p\_frame\_minimum\_qp\_value | 整型 | | | h264\_p\_frame\_maximum\_qp\_value | 整型 | | | h264\_b\_frame\_minimum\_qp\_value | 整型 | | | h264\_b\_frame\_maximum\_qp\_value | 整型 | | | h264\_hierarchical\_lay\_0\_bitrate | 整型 | | | h264\_hierarchical\_lay\_1\_bitrate | 整型 | | | h264\_hierarchical\_lay\_2\_bitrate | 整型 | | | h264\_hierarchical\_lay\_3\_bitrate | 整型 | | | h264\_hierarchical\_lay\_4\_bitrate | 整型 | | | h264\_hierarchical\_lay\_5\_bitrate | 整型 | | **上一级主题：** [显示、摄像头、编码和解码插件](https://docs.qualcomm.com/doc/80-70017-50SC/topic/display-plugins.html) Last Published: Nov 11, 2025 [Previous Topic v4l2h265dec](https://docs.qualcomm.com/bundle/publicresource/80-70017-50SC/topics/v4l2h265dec.md) [Next Topic v4l2h265enc](https://docs.qualcomm.com/bundle/publicresource/80-70017-50SC/topics/v4l2h265enc.md)