输出插件

mxpi_dataserialize

功能描述

将Stream结果组装成JSON字符串输出。用户可通过在配置文件中填写元件名,来选择需要输出的结果。

约束限制

同步/异步(status)

异步

插件基类(factory)

mxpi_dataserialize

输入和输出

  • 输入:buffer(数据类型“MxpiBuffer”)、metadata(数据类型“MxpiClassList”或“MxpiObjectList”)。
  • 输出:buffer(数据类型“MxpiBuffer”)。

端口格式(caps)

  • 静态输入:{"ANY"}。
  • 静态输出:{"result/json-result"}。

属性

请参见表1

表 1 mxpi_dataserialize插件的属性

属性名 描述 是否为必选项 是否可修改
outputDataKeys 指定需要输出的数据的索引(通常情况下为元件名称),以逗号隔开。此插件根据用户选择的元件名,将元件数据拼接成JSON字符串。该JSON字符串用于根据插件的依赖关系输出组装结果。
eraseHeaderVecFlag 是否要删除数据的header信息。需要设为1,不需要设为0,默认值为1。

appsink

功能描述

GStreamer原生插件。配合GetResult接口与GetResultWithUniqueId接口使用,从Stream中获取数据,当且仅当Stream中存在appsink插件时,以上两个接口有效。

约束限制

插件基类(factory)

appsink

输入和输出

  • 输入:buffer。
  • 输出:外部接口调用。

属性

具体请参见表1

表 1 appsink插件的属性

属性名 描述 是否为必选项 是否可修改
sync 同步锁,默认为加锁。
max-lateness 缓冲区(buffer)在被丢弃之前可以延迟的最大纳秒数,默认为-1,无限制。
qos 生成上游服务质量事件,默认为false。
async 异步转到暂停,默认为true。
ts-offset 时间戳偏移(以纳秒为单位),默认值为0。
enable-last-sample 启用最后一个样本(sample)属性,默认为true。
last-sample 只读属性,查看是否接收到最后的输出结果。
blocksize 每个buffer获取的大小(以字节为单位),默认值为4096。
render-delay 接收元件的附加呈现延迟(以纳秒为单位),默认值为0。
throttle-time 呈现buffer之间的保持时间,默认值为0,表示禁用。
max-bitrate 每秒要呈现的最大比特数,默认值为0,表示禁用。
processing-deadline 最大处理截止时间(以纳秒为单位),默认值为20000000。
caps 源衬垫(pad)允许的功能(capabilities)。
eos 检查接收元件是否是结束流(EOS)或未启动,默认为false。
emit-signals 发出新的预卷和新的采样信号,默认为false。
max-buffers 内部缓存的最大buffer数,默认值为0,无限制。
drop 队列被填充时丢弃旧的buffer,默认为false。
wait-on-eos 收到结束流(EOS)后,等待所有buffer处理完毕,默认true。
buffer-list 使用buffer列表。

fakesink

功能描述

GStreamer原生插件。一个吞噬任何数据的伪插件(黑洞插件),类似于Linux的/dev/null伪设备,用于丢弃不需要的数据。

约束限制

插件基类(factory)

fakesink

输入和输出

  • 输入:buffer。
  • 输出:无。

属性

filesink

[!NOTICE] 输出文件权限可能会过大,有文件信息泄露的风险。 在销毁流的过程中会直接停止所有插件的运行,请妥善保存所需的文件。

功能描述

GStreamer原生插件。把输入的数据写入文件并存储到本地。

约束限制

插件基类(factory)

filesink

输入和输出

  • 输入:buffer。
  • 输出:无。

属性

请参见表1

表 1 filesink插件的属性

属性名 描述 是否为必填项 是否可修改
append 添加到一个现有的文件上,默认为false。
buffer-mode 使用缓冲模式,默认为-1。-1:default(默认缓冲)0:full(完全缓冲)1:line(行缓冲,已弃用,类似完全缓冲)2:unbuffered(无缓冲)
buffer-size 设置buffer的大小,可设置需要的bytes,也可设置为buffer的最大值,默认为65536。
location 文件的位置,无默认值。
max-transient-error-timeout 当遇到瞬态错误时最多等待的毫秒时间(当前为EACCES),默认值为0。
o-sync 使用O_SYNC来打开文件,实现同步IO。默认值为false。