4.5 KiB
FDStreamer YAML配置文件指南
设计思想
FDStreamer的YAML配置文件 = AppConfig + GStreamer PIPELINE-DESCRIPTION String
换言之，FDStreamer的YAML配置文件可以被解析为一个AppConfig结构体和一个GStreamer PIPELINE-DESCRIPTION String。
AppConfig描述了应用层面的配置信息，包括App类型、是否打开性能测试等。具体可以查看base_app.h中的AppConfig结构体定义。
GStreamer PIPELINE-DESCRIPTION String则是由GStreamer框架定义的用于描述Pipeline的字符串，开发者可以使用GStreamer提供的命令行工具gst-launch-1.0对PIPELINE-DESCRIPTION字符串进行测试和验证。PIPELINE-DESCRIPTION由Element、Property、Link等元素组成。开发者可以使用GStreamer提供的命令行工具gst-inspect-1.0来搜索Element、查看Element的Property信息等。
更多信息可以查看GStreamer文档。
规则定义：
- FDStreamer YAML配置文件的一个配置模块，称为一个Node，Node由Node名称和若干个Node属性组成，Node属性个数可以为0
- 第一个Node必须为
app, 用于定义AppConfig - 除特殊定义的Node外，其余Node的名称必须为GStreamer Element的名称，也就是可以用
gst-inspect-1.0工具查询到的Element名称 - 除特殊定义的Node外，其余Node的属性名称必须为GStreamer Element Properties的名称，也就是可以用
gst-inspect-1.0工具查询到的Element Properties名称
通过以上的规则，实现了GStreamer Element及其Property的全覆盖，只要可以用gst-inspect-1.0工具查询到的，就可以写到FDStreamer的YAML配置文件中。可以灵活地配置Property、替换Element甚至修改Pipeline结构。
示例解析
如下的YAML配置文件，由5个Node组成，分别是：app、nvurisrcbin、nvvideoconvert、capsfilter和appsink。
除app Node外，其余都是GStreamer Element，Node名称和属性都可以通过gst-inspect-1.0工具查询到。对应的GStreamer Pipeline为：nvurisrcbin uri=file:///opt/sample_ride_bike.mov gpu-id=0 ! nvvideoconvert gpu-id=0 ! capsfilter caps="video/x-raw,format=(string)BGR" ! appsink sync=true max-buffers=60 drop=false
app:
type: video_decoder
enable-perf-measurement: true
perf-measurement-interval-sec: 5
nvurisrcbin:
uri: file:///opt/sample_ride_bike.mov
gpu-id: 0
nvvideoconvert:
gpu-id: 0
capsfilter:
caps: video/x-raw,format=(string)BGR
appsink:
sync: true
max-buffers: 60
drop: false
下面的例子有一个nvurisrcbin_list Node，其中包括了4个nvurisrcbin，这4个nvurisrcbin同时接入到了一个nvstreammux。对应的GStreamer Pipeline为：
nvurisrcbin uri=file:///opt/sample_ride_bike.mov gpu-id=1 ! mux.sink_0 nvurisrcbin uri=file:///opt/sample_ride_bike.mov gpu-id=1 ! mux.sink_1 nvurisrcbin uri=file:///opt/sample_ride_bike.mov gpu-id=1 ! mux.sink_2 nvurisrcbin uri=file:///opt/sample_ride_bike.mov gpu-id=1 ! mux.sink_3 nvstreammux name=mux gpu-id=1 batch-size=4
nvurisrcbin_list:
uri-list:
- file:///opt/sample_ride_bike.mov
- file:///opt/sample_ride_bike.mov
- file:///opt/sample_ride_bike.mov
- file:///opt/sample_ride_bike.mov
pad-prefix: mux.sink_
gpu-id: 0
nvstreammux:
name: mux
gpu-id: 0
batch-size: 4
特殊定义的Node和属性
app
用于定义AppConfig。具体的配置项可以查看base_app.h中的AppConfig结构体定义。
属性名称以小写命名，用-分隔，属性值以小写命名，用_分隔。
nvurisrcbin_list
先验知识：GStreamer Pad是Element的接口，sink pad表示输入接口，src pad表示输出接口。
用于定义多个nvurisrcbin，特殊的属性包括：
- uri-list: 用于定义多个uri，值类型为YAML list
- pad-prefix: 用于定义nvurisrcbin的src pad将连接到的sink pad的前缀，例如mux.sink_，当uri-list中有4个uri时，则4个nvurisrcbin的src pad分别连接到了mux.sink_0，mux.sink_1，mux.sink_2，mux.sink_3。而这四个pad则是名字为mux的元素的4个sink pad。
_link_to
_link_to是一个特殊的属性，用于设置该Element的src pad将连接到的sink pad的名称。该属性如果存在，必须写为最后一个属性。
_link_to用于单个Element，与pad-prefix功能类似，而pad-prefix用于list。