NVIDIA相关资料（一）——Deepstream相关知识

4.1.1 先决条件

• Ubuntu 18.04

• DeepStream SDK 5.1 或更高版本

• 蟒蛇 3.6

• Gst Python v1.14.5 如果Jetson 上缺少Gst python 安装，请使用以下命令安装：

  $ sudo apt-get install python-gi-dev
  $ export GST_LIBS="-lgstreamer-1.0 -lgobject-2.0 -lglib-2.0"
  $ export GST_CFLAGS="-pthread -I/usr/include/gstreamer-1.0 -I/usr/include/glib-2.0 -I/usr/lib/x86_64-linux-gnu/glib-2.0/include"
  $ git clone https://github.com/GStreamer/gst-python.git
  $ cd gst-python
  $ git checkout 1a8f48a
  $ ./autogen.sh PYTHON=python3
  $ ./configure PYTHON=python3
  $ make
  $ sudo make install
  

4.1.2 运行示例应用程序

1. 将deepstream_python_appsrepo克隆到：<DeepStream 5.1 ROOT>/sources

   git clone https://github.com/NVIDIA-AI-IOT/deepstream_python_apps
   

2. 这将创建以下目录：

   <DeepStream 5.1 ROOT>/sources/deepstream_python_apps
   

3. Python 应用程序位于该apps目录下。进入每个应用程序目录并按照自述文件中的说明进行操作。

管道建​​设：DeepStream 管道可以使用 Gst Python（GStreamer 框架的 Python 绑定）构建。有关管道构建示例，请参阅示例应用程序主要功能。（应用程序配置文件包含模型的相对路径）

4.2 元数据访问

4.2.1 内存管理

元数据的内存由 Python 和 C/C++ 代码路径共享。例如，一个MetaData项可能是由Python编写的probe函数添加的，需要由C/C++编写的下游插件访问。deepstream-test4 应用程序包含此类用法。Python 垃圾收集器无法查看 C/C++ 中的内存引用，因此无法安全地管理此类共享内存的生命周期。由于这种复杂性，Python 对 MetaData 内存的访问通常是通过引用实现的，而无需声明所有权。

4.2.2 分配

当在 Python 中分配 MetaData 对象时，绑定提供了一个分配函数来确保对象的正确内存所有权。如果使用构造函数，则对象将在其 Python 引用终止时被垃圾收集器声明。但是，该对象仍需要由下游的 C/C++ 代码访问，因此必须在这些 Python 引用之外持续存在。示例：要分配NvDsEventMsgMeta实例，请使用以下命令：

msg_meta = pyds.alloc_nvds_event_msg_meta() *# get reference to allocated instance without claiming memory ownership*

不是这个：

msg_meta = NvDsEventMsgMeta() *# memory will be freed by the garbage collector when msg_meta goes out of scope in Python*

分配器可用于以下结构：

• NvDsVehicleObject: alloc_nvds_vehicle_object()

• NvDsPersonObject: alloc_nvds_person_object()

• NvDsFaceObject: alloc_nvds_face_object()

• NvDsEventMsgMeta: alloc_nvds_event_msg_meta()

• NvDsEvent: alloc_nvds_event()

• NvDsPayload: alloc_nvds_payload()

• Generic buffer: alloc_buffer(size)

4.2.3 字符串访问

一些元数据结构包含字符串字段。以下部分提供了有关访问它们的详细信息。

obj.type = "Type"

pyds.free_buffer(obj.type)

obj = pyds.NvDsVehicleObject.cast(data);
print(obj.type)

print(pyds.get_string(obj.type))

4.2.4 铸件

一些 MetaData 实例以 GList 形式存储。要访问 GList 节点中的数据，需要将数据字段转换为适当的结构。此转换是通过目标类型的 cast() 成员函数完成的：

NvDsBatchMeta.cast
NvDsFrameMeta.cast
NvDsObjectMeta.cast
NvDsUserMeta.cast
NvDsClassifierMeta.cast
NvDsDisplayMeta.cast
NvDsLabelInfo.cast
NvDsEventMsgMeta.cast
NvDsVehicleObject.cast
NvDsPersonObject.cast

在 v0.5 版本中，提供了独立的强制转换功能。这些现在已被弃用并被上面的 cast() 函数取代：

glist_get_nvds_batch_meta
glist_get_nvds_frame_meta
glist_get_nvds_object_meta
glist_get_nvds_user_meta
glist_get_nvds_classifier_meta
glist_get_nvds_display_meta
glist_get_nvds_label_info
glist_get_nvds_event_msg_meta
glist_get_nvds_vehicle_object
glist_get_nvds_person_object

例子：

l_frame = batch_meta.frame_meta_list
frame_meta = pyds.NvDsFrameMeta.cast(l_frame.data)

4.2.5 回调函数注册

添加到 NvDsUserMeta 的自定义元数据需要自定义复制和发布功能。MetaData 库依赖于这些自定义函数来执行自定义结构的深度复制，并释放分配的资源。这些函数在 NvDsUserMeta 结构中注册为回调函数指针。使用以下函数注册回调函数：pyds.set_user_copyfunc(NvDsUserMeta_instance, copy_function) pyds.set_user_releasefunc(NvDsUserMeta_instance, free_func)

另：在应用程序退出之前，回调需要在绑定库中取消注册。绑定库当前保留对已注册函数的全局引用，并且这些引用不能持续到应用程序退出时发生的绑定库卸载之后。使用以下函数取消注册所有回调：pyds.unset_callback_funcs()

有关回调注册和注销的示例，请参阅 deepstream-test4 示例应用程序。

限制：绑定库目前仅支持每个应用程序的一组回调函数。将使用最后注册的函数。

4.2.6 优化和实用程序

Python 解释通常比运行编译的 C/C++ 代码慢。为了提供更好的性能，一些操作是用 C 实现的，并通过绑定接口公开。目前这是实验性的，将随着时间的推移而扩展。提供以下优化功能：

• pyds.NvOSD_ColorParams.set(double red, double green, double blue, double alpha)

  这是一个简单的函数，执行与以下相同的操作：

  txt_params.text_bg_clr.red = red
  txt_params.text_bg_clr.green = green
  txt_params.text_bg_clr.blue = blue
  txt_params.text_bg_clr.alpha = alpha
  

  这些在 deepstream_test_4.py 中的每个对象上执行，导致聚合处理时间减慢管道。将此函数推入 C 层有助于提高性能。

• generate_ts_rfc3339 (buffer, buffer_size)

  此函数使用根据 RFC3339 生成的时间戳填充输入缓冲区： %Y-%m-%dT%H:%M:%S.nnnZ\0

4.2.7 图像数据访问

解码后的图像可以NumPy通过该get_nvds_buf_surface函数以数组的形式访问。该函数记录在 API 指南中。有关deepstream-imagedata-multistream图像数据使用的示例，请参阅示例应用程序。

4.3 示例应用程序源详细信息

5.2.1 DeepStream 参考应用程序 (deepstream-app) 的预期输出

下图显示了预期的输出：

5.3.1 应用组

应用程序组属性是：

应用组

钥匙	意义	类型和值	例子	平台
启用性能测量	指示是否启用应用程序性能测量。	布尔值	启用性能测量=1	dGPU，杰森
性能测量间隔秒	采样和打印性能指标的时间间隔（以秒为单位）。	整数，>0	性能测量间隔秒=10	dGPU，杰森
gie-kitti-输出目录	应用程序以修改后的 KITTI 元数据格式存储主要检测器输出的现有目录的路径名。	细绳	gie-kitti-output-dir=/home/ubuntu/kitti_data/	dGPU，杰森
kitti-track-output-dir	应用程序以修改后的 KITTI 元数据格式存储跟踪器输出的现有目录的路径名。	细绳	kitti-track-output-dir=/home/ubuntu/kitti_data_tracker/	dGPU，杰森

5.3.2 平铺展示组

平铺显示组属性是：

平铺显示组

钥匙	意义	类型和值	例子	平台
使能够	指示是否启用平铺显示。当用户设置 enable=2 时，第一个带有 key:link-to-demux=1 的 [sink] 组应链接到 demuxer 的 src_[source_id] pad，其中 source_id 是相应 [sink] 组中设置的键。	整数，0 = 禁用，1 = tiler-enabled 2 = tiler-and-parallel-demux-to-sink-enabled	启用=1	dGPU，杰森
行	平铺二维数组中的行数。	整数，>0	行数=5	dGPU，杰森
列	平铺二维数组中的列数。	整数，>0	列=6	dGPU，杰森
宽度	平铺二维数组的宽度，以像素为单位。	整数，>0	宽度=1280	dGPU，杰森
高度	平铺二维阵列的高度，以像素为单位。	整数，>0	高度=720	dGPU，杰森
gpu-id	在多个 GPU 的情况下，元素将使用 GPU。	整数，≥0	gpu-id=0	图形处理器
nvbuf 内存类型	元素为输出缓冲区分配的内存类型。0 (nvbuf-mem-default)：特定于平台的默认类型 1 (nvbuf-mem-cuda-pinned)：固定/主机 ​​CUDA 内存 2 (nvbuf-mem-cuda-device)：设备 CUDA 内存 3 (nvbuf-mem -cuda-unified)：统一 CUDA 内存 对于 dGPU：所有值均有效。对于 Jetson：只有 0（零）有效。	整数、0、1、2 或 3	nvbuf-内存类型=3	dGPU，杰森

5.3.3 源组

源组指定源属性。DeepStream 应用程序支持多个同步源。对于每个源，source%d必须将带有组名称的单独组添加到配置文件中。例如：

[source0]
key1=value1
key2=value2
...

[source1]
key1=value1
key2=value2
...

源组属性是：

源组

钥匙	意义	类型和值	例子	平台
使能够	启用或禁用源。	布尔值	启用=1	dGPU，杰森
类型	来源类型；源的其他属性取决于此类型。 1：相机（V4L2） 2：URI 3：多URI 4：RTSP 5：相机（CSI）（仅限Jetson）	整数、1、2、3、4 或 5	类型=1	dGPU，杰森
恨	编码流的 URI。URI 可以是文件、HTTP URI 或 RTSP 实时源。当 type=2 或 3 时有效。对于 MultiURI，%d 格式说明符也可用于指定多个源。应用程序从 0 迭代到 num-sources 1 以生成实际的 URI。	细绳	uri=file:///home/ubuntu/source.mp4 uri=http://127.0.0.1/source.mp4 uri=rtsp://127.0.0.1/source1 uri=file:///home/ubuntu/source_ %d.mp4	dGPU，杰森
数字来源	来源数量。仅当 type=3 时有效。	整数，≥0	数量来源=2	dGPU，杰森
内解码启用	启用或禁用仅内解码。	布尔值	内解码启用=1	dGPU，杰森
数量额外的表面	除了解码器给出的最小解码表面之外的表面数量。可用于管理流水线中解码器输出缓冲区的数量。	整数，≥0 且≤24	num-extra-surfaces=5	dGPU，杰森
gpu-id	在多个 GPU 的情况下，元素将使用 GPU。	整数，≥0	gpu-id=1	图形处理器
相机编号	要添加到元数据的输入源的唯一 ID。（可选的）	整数，≥0	相机 ID=2	dGPU，杰森
相机宽度	要从相机请求的帧的宽度，以像素为单位。当 type=1 或 5 时有效。	整数，>0	相机宽度=1920	dGPU，杰森
相机高度	要从相机请求的帧的高度，以像素为单位。当 type=1 或 5 时有效。	整数，>0	相机高度=1080	dGPU，杰森
相机-fps-n	指定相机请求的帧速率的分数的分子部分，以帧/秒为单位。当 type=1 或 5 时有效。	整数，>0	相机-fps-n=30	dGPU，杰森
相机-fps-d	指定从相机请求的帧速率的分数的分母部分，以帧/秒为单位。当 type = 1 或 5 时有效。	整数，>0	相机-fps-d=1	dGPU，杰森
相机-v4l2-dev-node	V4L2设备节点编号。例如，/dev/video<num> 用于开源 V4L2 相机捕获路径。当类型设置（源类型）为 1 时有效。	整数，>0	相机-v4l2-dev-node=1	dGPU，杰森
潜伏	以毫秒为单位的抖动缓冲区大小；仅适用于 RTSP 流。	整数，≥0	延迟=200	dGPU，杰森
相机-CSI-传感器-ID	摄像头模块的传感器 ID。当类型（源类型）为 5 时有效。	整数，≥0	相机-CSI-传感器-id=1	杰森
丢帧间隔	丢帧间隔。例如，5 表示解码器每五帧输出一次；0 表示不丢帧。	整数，	丢帧间隔=5	dGPU，杰森
cudadec-memtype	用于为类型 2,3 或 4 的源分配输出缓冲区的 CUDA 内存元素类型。不适用于 CSI 或 USB 相机源 0 (memtype_device)：使用 cudaMalloc() 分配的设备内存。 1 (memtype_pinned)：使用 cudaMallocHost() 分配的主机/固定内存。 2 (memtype_unified)：使用 cudaMallocManaged() 分配的统一内存。	整数、0、1 或 2	cudadec-memtype=1	图形处理器
nvbuf 内存类型	元素为 nvvideoconvert 的输出缓冲区分配的 CUDA 内存类型，对于类型 1 的源很有用。 0（nvbuf-mem-default，特定于平台的默认值 1 (nvbuf-mem-cuda-pinned)：固定/主机 ​​CUDA 内存。 2 (nvbuf-mem-cuda-device)：设备 CUDA 内存。 3 (nvbuf-mem-cuda-unified)：统一CUDA内存。 对于 dGPU：所有值均有效。 对于 Jetson：只有 0（零）有效。	整数、0、1、2 或 3	nvbuf-内存类型=3	dGPU,Jetson
选择-rtp-协议	用于 RTP 的传输协议。当 type（源类型）为 4 时有效。 0：UDP + UDP 组播 + TCP 4：仅 TCP	整数，0 或 4	选择-rtp-协议=4	dGPU，杰森
rtsp-重新连接-间隔-秒	在强制重新连接之前从 RTSP 源接收到最后一个数据后等待的超时时间（以秒为单位）。将其设置为 0 将禁用重新连接。当 type（源类型）为 4 时有效。	整数，≥0	rtsp-重新连接-间隔-秒=60	dGPU，杰森
智能记录	触发智能记录的方法。 0：禁用 1：只能通过云消息 2：云消息+本地事件	整数，0、1 或 2	智能记录=1	dGPU，杰森
智能记录目录路径	保存录制文件的目录路径。默认情况下，使用当前目录。	细绳	smart-rec-dir-path = / home / nvidia /	dGPU，杰森
智能记录文件前缀	录制视频的文件名前缀。默认情况下，Smart_Record 是前缀。对于唯一的文件名，必须为每个源提供一个唯一的前缀。	细绳	smart-rec-file-prefix=Cam1	dGPU，杰森
智能录制视频缓存	以秒为单位的视频缓存大小。	整数，≥0	smart-rec-video-cache=20	dGPU，杰森
智能记录容器	录制视频的容器格式。支持 MP4 和 MKV 容器。	整数，0 或 1	智能记录容器=0	dGPU，杰森
智能记录开始时间	从现在开始记录的提前秒数。例如，如果 t0 是当前时间，N 是开始时间（以秒为单位），这意味着录制将从 t0 – N 开始。显然，要使其工作，视频缓存大小必须大于 N。	整数，≥0	智能记录开始时间=5	dGPU，杰森
智能记录默认持续时间	如果未生成停止事件。此参数将确保录制在预定义的默认持续时间后停止。	整数，≥0	smart-rec-default-duration=20	dGPU，杰森
智能记录持续时间	以秒为单位的记录持续时间。	整数，≥0	智能记录持续时间=15	dGPU，杰森
智能记录间隔	这是 SR 启动/停止事件生成的时间间隔（以秒为单位）。	整数，≥0	智能记录间隔=10	dGPU，杰森

5.3.4 流复用组

[streammux] 组指定和修改 Gst-nvstreammux 插件的属性。

流复用组

钥匙	意义	类型和值	例子	平台
gpu-id	GPU 元素用于多个 GPU 的情况。	整数，≥0	gpu-id=1	图形处理器
直播源	通知多路复用器源是实时的。	布尔值	直播源=0	dGPU，杰森
批量大小	多路复用器批量大小。	整数，>0	批量大小=4	dGPU，杰森
批量推送超时	在第一个缓冲区可用后推送批次后的超时时间（以微秒为单位），即使没有形成完整的批次。	整数，≥−1	批量推送超时=40000	dGPU，杰森
宽度	多路复用器输出宽度（以像素为单位）。	整数，>0	宽度=1280	dGPU，杰森
高度	多路复用器输出高度（以像素为单位）。	整数，>0	高度=720	dGPU，杰森
启用填充	指示在通过添加黑带进行缩放时是否保持源纵横比。	布尔值	启用填充=0	dGPU，杰森
nvbuf 内存类型	元素为输出缓冲区分配的 CUDA 内存类型。 0（nvbuf-mem-default，特定于平台的默认值 1 (nvbuf-mem-cuda-pinned)：固定/主机 ​​CUDA 内存。 2 (nvbuf-mem-cuda-device)：设备 CUDA 内存。 3 (nvbuf-mem-cuda-unified)：统一CUDA内存。 对于 dGPU：所有值均有效。 对于 Jetson：只有 0（零）有效。	整数、0、1、2 或 3	nvbuf-内存类型=3	图形处理器
附加-sys-ts-as-ntp	对于实时源，当流式传输 RTSP 时，混合缓冲区应将关联的 NvDsFrameMeta->ntp_timestamp 设置为系统时间或服务器的 NTP 时间。 如果设置为 1，系统时间戳将作为 ntp 时间戳附加。 如果设置为 0，则将附加来自 rtspsrc 的 ntp 时间戳（如果可用）。	布尔值	附加-sys-ts-as-ntp=0	dGPU，杰森
配置文件路径	此密钥仅对新的流复用器有效。有关更多信息，请参阅插件手册部分“New Gst-nvstreammux”。mux 配置文件的绝对或相对（到 DS 配置文件位置）路径。	细绳	配置文件路径=config_mux_source30.txt	dGPU，杰森

5.3.5 初级 GIE 和次级 GIE 组

DeepStream 应用程序支持多个辅助 GIE。对于每个辅助 GIE，secondary-gie%d必须将具有名称的单独组添加到配置文件中。例如：

[primary-gie]
key1=value1
key2=value2
...

[secondary-gie1]
key1=value1
key2=value2
...

主要和次要 GIE 配置如下。对于每个配置，Valid for 列指示配置属性是对主要还是次要 TensorRT 模型有效，还是对两个模型都有效。

小学和中学 GIE* 组

钥匙	意义	类型和值	例子	平台/ GIE*
使能够	指示是否必须启用主 GIE。	布尔值	启用=1	dGPU，Jetson 两个 GIE
唯一标识	要分配给 nvinfer 实例的唯一组件 ID。用于标识实例生成的元数据。	整数，>0	gie-unique-id = 2	两个都
gpu-id	在多个 GPU 的情况下，元素将使用 GPU。	整数，≥0	gpu-id=1	dGPU，两个 GIE
模型引擎文件	模式的预生成序列化引擎文件的绝对路径名。	细绳	模型引擎文件=../../models/Primary_Detector/resnet10. caffemodel_b4_int8.engine	两个 GIE
nvbuf 内存类型	CUDA 内存元素的类型是分配给输出缓冲区。 0 (nvbuf-mem-default)：特定于平台的默认值 1 (nvbuf-mem-cuda-pinned): pinned/host CUDA 内存 2（nvbuf-mem-cuda-device）：设备CUDA内存 3（nvbuf-mem-cuda-unified）：统一CUDA内存 对于 dGPU：所有值均有效。 对于 Jetson：只有 0（零）有效。	整数、0、1、2 或 3	nvbuf-内存类型=3	dGPU，Jetson 初级 GIE
配置文件	指定 Gst-nvinfer 插件属性的配置文件的路径名。它可能包含此表中描述的任何属性，但配置文件本身除外。属性必须在名为 [property] 的组中定义。有关参数的更多详细信息，请参阅 DeepStream 4.0 插件手册中的“Gst-nvinfer 文件配置规范”。	细绳	config-file=¬/home/-ubuntu/-config_infer_resnet.txt 有关完整示例，请参阅示例文件 samples/¬configs/-deepstream-app/-config_infer_resnet.txt 或 deepstream-test2 示例应用程序。	dGPU，Jetson 两个 GIE
批量大小	批量推断的帧数（P.GIE）/对象（S.GIE）。	整数，>0 整数，>0	批量大小=2	dGPU，Jetson 两个 GIE
间隔	要跳过以进行推理的连续批次数。	整数，>0 整数，>0	间隔=2	dGPU，Jetson 初级 GIE
bbox边框颜色	特定类 ID 的对象的边框颜色，以 RGBA 格式指定。密钥的格式必须为 bbox-border-color<class-id>。可以为多个类 ID 多次标识此属性。如果未为类 ID 标识此属性，则不会为该类 ID 的对象绘制边框。	R:G:B:A 浮点数，0≤R,G,B,A≤1	bbox-border-color2= 1;0;0;1（红色表示类 ID 2）	dGPU，Jetson 两个 GIE
bbox-bg-颜色	在特定类 ID 的对象上绘制的框的颜色，采用 RGBA 格式。密钥的格式必须为 bbox-bg-color<class-id>。此属性可以多次用于多个类 ID。如果它不用于类 ID，则不会为该类 ID 的对象绘制框。	R:G:B:A 浮点数，0≤R,G,B,A≤1	bbox-bg-color3=-0;1;0;0.3（class-id 3 的半透明绿色）	dGPU，Jetson 两个 GIE
操作 gie-id	GIE 的唯一 ID，此 GIE 将在其元数据 (NvDsFrameMeta) 上运行。	整数，>0	操作 gie-id=1	dGPU，Jetson 二级 GIE
操作类 ID	此 GIE 必须在其上运行的父 GIE 的类 ID。使用 operation-on-gie-id 指定父 GIE。	分号分隔的整数数组	operation-on-class-ids=1;2（对父 GIE 生成的类 ID 为 1、2 的对象进行操作）	dGPU，Jetson 二级 GIE
推断原始输出目录	将原始推理缓冲区内容转储到文件中的现有目录的路径名。	细绳	infer-raw-output-dir=/home/ubuntu/infer_raw_out	dGPU，Jetson 两个 GIE
标签文件路径	标签文件的路径名。	细绳	labelfile-path=../../models/Primary_Detector/labels.txt	dGPU，Jetson 两个 GIE
插件类型	用于推理的插件。0：nvinfer（TensorRT） 1：nvinferserver（Triton 推理服务器）	整数，0 或 1	插件类型=1	dGPU，Jetson 两个 GIE

5.3.6 追踪组

跟踪器组属性是：

跟踪器组

钥匙	意义	类型和值	例子	平台
使能够	启用或禁用跟踪器。	布尔值	启用=1	dGPU，杰森
跟踪宽度	跟踪器将运行的帧宽度，以像素为单位。	整数，≥0	跟踪器宽度= 960	dGPU，杰森
追踪高度	跟踪器将运行的帧高度，以像素为单位。	整数，≥0	追踪高度=540	dGPU，杰森
gpu-id	在多个 GPU 的情况下，元素将使用 GPU。	整数，≥0	gpu-id=1	图形处理器
配置文件	低级跟踪器配置文件的路径名。	细绳	ll-config-file=iou_config.txt	dGPU，杰森
ll-lib-文件	低级跟踪器实现库的路径名。	细绳	ll-lib-file=/usr/-local/deepstream/libnvds_mot_iou.so	dGPU，杰森
启用批处理	启用跨多个流的批处理。	布尔值	启用批处理=1	dGPU，杰森
启用过去帧	启用报告过去帧数据	布尔值	启用过去帧=1	dGPU，杰森
跟踪表面类型	设置用于跟踪的表面流类型。（默认值为 0）	整数，≥0	跟踪表面类型=0	dGPU，杰森
显示跟踪 ID	启用跟踪 ID 显示。	布尔值	显示跟踪 ID=1	dGPU，杰森

5.3.7 消息转换器组

消息转换器组属性是：

消息转换器组

钥匙	意义	类型和值	例子	平台
使能够	启用或禁用消息转换器。	布尔值	启用=1	dGPU，杰森
msg-conv-config	Gst-nvmsgconv 元素的配置文件的路径名。	细绳	msg-conv-config=dstest5_msgconv_sample_config.txt	dGPU，杰森
msg-conv-payload-type	有效载荷的类型。 0、PAYLOAD_DEEPSTREAM：Deepstream 模式负载。 1、PAYLOAD_DEEPSTREAM_MINIMAL：Deepstream schema的payload最小。 256、PAYLOAD_RESERVED：保留类型。 257、PAYLOAD_CUSTOM：自定义模式负载。	整数 0、1、256 或 257	msg-conv-payload-type=0	dGPU，杰森
msg-conv-msg2p-lib	可选的自定义负载生成库的绝对路径名。该库实现了由 sources/libs/nvmsgconv/nvmsgconv.h 定义的 API。	细绳	msg-conv-msg2p-lib=/opt/nvidia/deepstream/deepstream-4.0/lib/libnvds_msgconv.so	dGPU，杰森
msg-conv-comp-id	gst-nvmsgconv 元素的 comp-id Gst 属性。这是附加必须由 gst-nvmsgconv 元素处理的 NvDsEventMsgMeta 的组件的 ID。	整数，>=0	msg-conv-comp-id=1	dGPU，杰森

5.3.8 消息消费者组

消息消费者组属性是：

消息消费者组

钥匙	意义	类型和值	例子	平台
使能够	启用或禁用消息使用者。	布尔值	启用=1	dGPU，杰森
原型库	具有协议适配器实现的库的路径。	细绳	proto-lib=/opt/nvidia/deepstream/deepstream-4.0/lib/libnvds_kafka_proto.so	dGPU，杰森
连接字符串	服务器的连接字符串。	细绳	conn-str=foo.bar.com;80	dGPU，杰森
配置文件	具有协议适配器附加配置的文件的路径，	细绳	配置文件=../cfg_kafka.txt	dGPU，杰森
订阅主题列表	要订阅的主题列表。	细绳	订阅主题列表=toipc1;topic2;topic3	dGPU，杰森
传感器列表文件	具有从传感器索引到传感器名称的映射的文件。	细绳	传感器列表文件=dstest5_msgconv_sample_config.txt	dGPU，杰森

5.3.9 OSD组

OSD 组指定属性并修改 OSD 组件的行为，该组件在视频帧上覆盖文本和矩形。

OSD组

钥匙	意义	类型和值	例子	平台
使能够	启用或禁用屏幕显示 (OSD)。	布尔值	启用=1	dGPU，杰森
gpu-id	在多个 GPU 的情况下，元素将使用 GPU。	整数，≥0	gpu-id=1	图形处理器
边框宽度	为对象绘制的边界框的边框宽度，以像素为单位。	整数，≥0	边框宽度=10	dGPU，杰森
边框颜色	为对象绘制的边界框的边框颜色。	R;G;B;A 浮点数, 0≤R,G,B,A≤1	边框颜色=0;0;0.7;1 #深蓝色	dGPU，杰森
字体大小	描述对象的文本大小，以磅为单位。	整数，≥0	文字大小=16	dGPU，杰森
文字颜色	描述对象的文本颜色，采用 RGBA 格式。	R;G;B;A 浮点数, 0≤R,G,B,A≤1	文本颜色=0;0;0.7;1 #深蓝色	dGPU，杰森
文字背景颜色	描述对象的文本的背景颜色，采用 RGBA 格式。	R;G;B;A 浮点数, 0≤R,G,B,A≤1	text-bg-color=0;0;0;0.5 #半透明黑色	dGPU，杰森
时钟文本大小	时钟时间文本的大小，以磅为单位。	整数，>0	时钟文本大小=16	dGPU，杰森
时钟x偏移	时钟时间文本的水平偏移量，以像素为单位。	整数，>0	时钟-x-偏移=100	dGPU，杰森
时钟偏移	时钟时间文本的垂直偏移量，以像素为单位。	整数，>0	时钟-y-偏移=100	dGPU，杰森
制作	描述对象的文本的字体名称。	细绳	字体=Purisa	dGPU，杰森
	输入 shell 命令 fc-list 以显示可用字体的名称。
时钟颜色	时钟时间文本的颜色，RGBA 格式。	R;G;B;A 浮点数, 0≤R,G,B,A≤1	时钟颜色=1;0;0;1 #红色	dGPU，杰森
nvbuf 内存类型	元素为输出缓冲区分配的 CUDA 内存类型。 0 (nvbuf-mem-default)：特定于平台的默认值 1 (nvbuf-mem-cuda-pinned): pinned/host CUDA 内存 2（nvbuf-mem-cuda-device）：设备CUDA内存 3（nvbuf-mem-cuda-unified）：统一CUDA内存 对于 dGPU：所有值均有效。 对于 Jetson：只有 0（零）有效。	整数、0、1、2 或 3	nvbuf-内存类型=3	图形处理器
过程模式	NvOSD 处理模式。 0：CPU 1：GPU（仅dGPU） 2：硬件（仅限Jetson）	整数、0、1 或 2	进程模式=1	dGPU，杰森
显示文本	指示是否显示文本	布尔值	显示文本=1	dGPU，杰森
显示框	指示是否为边界框	布尔值	显示框=1	dGPU，杰森
显示掩码	指示是否显示实例掩码	布尔值	显示掩码=1	dGPU，杰森
hw-blend-color-attr	混合所有类的颜色属性。用于 process-mode=2（基于 VIC 的混合）。如果设置了此属性，则将使用混合绘制阴影 bbox。属性以以下形式设置：“Class_ID,R,G,B,A”，每个类用“:”分隔，仅适用于 Jetson。 请注意，对于 VIC 模式，必须设置此属性，否则对象将无法与所需颜色混合。如果在主 gie 中指定了 bbox-bg-color 值，则对象将与 nvdsosd 插件中定义的 DEFAULT_CLR 参数混合。	细绳	hw-blend-color-attr=0,0.0,1.0,0.0,0.3:1,1.0,0.0,0.3.0.3	杰森

5.3.10 水槽组

接收器组指定属性并修改接收器组件用于渲染、编码和文件保存的行为。

水槽组

钥匙	意义	类型和值	例子	平台
使能够	启用或禁用接收器。	布尔值	启用=1	dGPU，杰森
类型	使用的水槽类型。 1：假货 2：基于 EGL 的窗口接收器 (nveglglessink) 3：编码+文件保存（编码器+复用器+文件接收器） 4：编码+RTSP流 5：叠加（仅限Jetson） 6：消息转换器+消息代理	整数、1、2、3、4、5 或 6	类型=2	dGPU，杰森
同步	指示流的渲染速度。 0：尽可能快 1：同步	整数，0 或 1	同步=1	dGPU，杰森
服务质量	指示接收器是否要生成服务质量事件，当管道 FPS 跟不上流帧速率时，这可能导致管道丢帧。	布尔值	服务质量=0	dGPU，杰森
源标识	此接收器必须使用其缓冲区的源的 ID。源 ID 包含在源组名称中。例如，对于组 [source1] source-id=1。	整数，≥0	源 ID=1	dGPU，杰森
gpu-id	在多个 GPU 的情况下，元素将使用 GPU。	整数，≥0	gpu-id=1	图形处理器
容器	用于文件保存的容器。仅对 type=3 有效。| 1：MP4 | 2：MKV	整数，1 或 2	容器=1	dGPU，杰森
编解码器	用于保存文件的编码器。 1：H.264（硬件） 2：H.265（硬件）	整数，1 或 2	编解码器=1	dGPU，杰森
比特率	用于编码的比特率，以每秒比特数为单位。对 type=3 和 4 有效。	整数，>0	比特率=4000000	dGPU，杰森
iframe 间隔	编码帧内出现频率。	整数，0≤iv≤MAX_INT	iframeinterval = 30	dGPU，杰森
输出文件	输出编码文件的路径名。仅对 type=3 有效。	细绳	输出文件=/home/ubuntu/output.mp4	dGPU，杰森
nvbuf 内存类型	插件为输出缓冲区分配的 CUDA 内存类型。 0 (nvbuf-mem-default)：特定于平台的默认值 1 (nvbuf-mem-cuda-pinned): pinned/host CUDA 内存 2（nvbuf-mem-cuda-device）：设备CUDA内存 3（nvbuf-mem-cuda-unified）：统一CUDA内存 对于 dGPU：所有值均有效。 对于 Jetson：只有 0（零）有效。	整数、0、1、2 或 3	nvbuf-内存类型=3	dGPU，杰森
rtsp端口	RTSP 流媒体服务器的端口；一个有效的未使用的端口号。对类型=4 有效。	整数	rtsp-端口=8554	dGPU，杰森
UDP端口	流实现内部使用的端口 - 有效的未使用端口号。对类型=4 有效。	整数	udp 端口​​=5400	dGPU，杰森
覆盖ID	用于 HEAD 0 的叠加索引。对叠加接收器有效（类型 = 5）。	整数，>=1	overlay-id=1 必须小于 HEAD 0 支持的覆盖数量。	图形处理器
宽度	渲染器的宽度（以像素为单位）。	整数，>=1	宽度=1920	dGPU，杰森
高度	渲染器的高度（以像素为单位）。	整数，>=1	高度=1920	dGPU，杰森
偏移-x	渲染器窗口的水平偏移量，以像素为单位。	整数，>=1	偏移-x=100	dGPU，杰森
偏移-y	渲染器窗口的垂直偏移，以像素为单位。	整数，>=1	偏移-y = 100	dGPU，杰森
显示 ID	显示器 HEAD 的 ID。适用于覆盖接收器（类型 = 5）。	整数，≥0	显示 ID=0	杰森
msg-conv-config	Gst-nvmsgconv 元素的配置文件的路径名（type=6）。	细绳	msg-conv-config=dstest5_msgconv_sample_config.txt	dGPU，杰森
msg-broker-proto-lib	协议适配器实现的路径使用 Gst-nvmsgbroker (type=6)。	细绳	msg-broker-proto-lib=/opt/nvidia/deepstream/deepstream-5.0/lib/libnvds_amqp_proto.so	dGPU，杰森
msg-broker-conn-str	后端服务器的连接字符串（type=6）。	细绳	msg-broker-conn-str=foo.bar.com;80;dsapp	dGPU，杰森
话题	消息主题的名称（类型=6）。	细绳	主题=测试-ds4	dGPU，杰森
msg-conv-payload-type	有效载荷的类型。 0、PAYLOAD_DEEPSTREAM：DeepStream 模式负载。 1、PAYLOAD_DEEPSTREAM_-MINIMAL：DeepStream schema的payload最小。 256、PAYLOAD_RESERVED：保留类型。 257、PAYLOAD_CUSTOM：自定义模式负载（类型=6）。	整数 0、1、256 或 257	msg-conv-payload-type=0	dGPU，杰森
消息代理配置	Gst-nvmsgbroker 元素的可选配置文件的路径名（type=6）。	细绳	msg-conv-config=/home/ubuntu/cfg_amqp.txt	dGPU，杰森
新的api	直接使用协议适配器库 api 或使用新的 msgbroker 库包装器 api	整数 0 : 直接使用适配器 api 1 : msgbroker lib 包装器 api	新 API = 0	dGPU，杰森
msg-conv-msg2p-lib	可选的自定义负载生成库的绝对路径名。该库实现了由 sources/libs/nvmsgconv/nvmsgconv.h 定义的 API。仅当 msg-conv-payload-type=257, PAYLOAD_CUSTOM 时适用。	细绳	msg-conv-msg2p-lib=/opt/nvidia/deepstream/deepstream-4.0/lib/libnvds_msgconv.so	dGPU，杰森
msg-conv-comp-id	nvmsgconv 元素的 comp-id Gst 属性；要从中处理元数据的主要/次要 gie 组件的 ID（gie-unique-id）。	整数，>=0	msg-conv-comp-id=1	dGPU，杰森
msg-broker-comp-id	nvmsgbroker 元素的 comp-id Gst 属性；要从中处理元数据的主要/次要 gie 组件的 ID (gie-unique-id)。	整数，>=0	msg-broker-comp-id=1	dGPU，杰森
禁用-msgconv	只添加消息代理组件而不是消息转换器+消息代理。	整数，	禁用-msgconv = 1	dGPU，杰森
enc 类型	用于编码器的引擎 0：NVENC硬件引擎 1：CPU软件编码器	整数，0 或 1	编码类型=0	dGPU，杰森
个人资料（硬件）	编解码器 V4L2 H264 编码器 (HW) 的编码器配置文件： 0：基线 2：主要 4：高 V4L2 H265编码器（硬件）： 0：主要 1：主要10	来自旁边列的整数，有效值	个人资料=2	dGPU，杰森
udp 缓冲区大小	内部 RTSP 输出管道的 UDP 内核缓冲区大小（以字节为单位）。	整数，>=0	udp 缓冲区大小=100000	dGPU，杰森
链接到解复用器	一个布尔值，用于启用或禁用将特定“源 ID”单独流式传输到此接收器。 请检查平铺显示组启用键以获取更多信息。	布尔值	链接到解复用器=0	dGPU，杰森

5.3.11 测试组

测试组用于诊断和调试。

测试组

钥匙	意义	类型和值	例子	平台
文件循环	指示是否应无限循环输入文件。	布尔值	文件循环=1	dGPU，杰森

5.3.12 NvDs-analytics Group

该[nvds-analytics]组用于在管道中添加 nvds-analytics 插件。

5.4.1 性能优化

本节介绍了您可以尝试以获得最佳性能的各种性能优化步骤。

5.4.2 减少虚假检测

使用 OTA 功能

执行以下操作以使用 OTA 功能：

1. deepstream-test5-app使用选项运行-o <ota_override_file>

2. 在 DS 应用程序运行时，<ota_override_file>使用新的模型详细信息更新并保存

3. 文件内容更改被检测到deepstream-test5-app，然后它开始模型更新过程。目前仅支持模型更新功能作为 OTA 功能的一部分。

On-The-Fly 模型更新的假设：

1. 新模型必须具有与先前模型相同的网络参数配置（例如网络分辨率、网络架构、类数）

2. 开发者提供的新模型的引擎文件或缓存文件

3. 其他配置参数（如、、、等）的更新值（如果在覆盖文件中提供）在模型切换后不会产生任何影响。primary giegroup-thresholdbbox colorgpu-idnvbuf-memory-type

4. Secondary gie 未验证模型更新，仅验证主要模型更新。

5. 在动态模型更新过程中不应观察到无帧丢失/无推理的帧

6. 如果模型更新失败，将在控制台上打印错误消息，管道应继续使用较旧的模型配置运行

7. 需要 config-file参数来抑制配置文件解析错误打印，模型切换过程中不使用此配置文件中的值