本文介绍了单源单输出官方数据流模板。单源单输出模板适用于视频数据流，表示从单个输入算子获取视频流，经过一系列处理后，将处理结果推送到单个输出算子。
基本信息
您可以在边缘智能控制台的官方模板列表访问本模板。下图展示了本模板的基本信息。
版本列表
本模板提供如下可用版本。
版本名称 | 说明 |
|---|---|
从 RTSP 源拉流作为输入，使用模型服务进行物体检测，然后将检测结果以 RTSP 推流形式输出。 | |
从 RTMP 源拉流作为输入，使用模型服务进行物体检测，然后将检测结果以 RTMP 推流形式输出。 | |
从接入边缘节点的摄像头设备拉取视频流作为输入，使用模型服务进行物体检测，然后将检测结果推送到虚拟视频设备进行输出。 | |
从 RTSP 源拉流作为输入，使用模型服务进行物体检测并将检测结果转换为消息，然后将消息推送到虚拟时序设备进行输出。 | |
从 RTSP 源拉流作为输入，使用模型服务进行物体检测，然后将分析结果转换为消息并推送到数据流事件中心进行输出。 | |
从 RTSP 源拉流作为输入，使用模型服务进行物体检测，然后执行特定行为分析，最后将分析结果转换为消息并推送到 Kafka 服务器进行输出。 | |
从 RTSP 源拉流作为输入，使用模型服务进行物体检测，然后将分析结果转换为消息并推送到数据流事件中心进行输出。 说明 v7 版本和 v5 版本的区别在于：v7 中使用“推理服务”算子，而 v5 中使用“物体检测”算子。“推理服务”算子和“物体检测”算子的用途是一样的，“推理服务”算子允许您自定义推理的配置，“物体检测”算子则使用了较多默认的配置。关于算子的详细说明，请参见视频数据流算子。 | |
从 RTSP 源拉流作为输入，使用模型服务进行物体检测，然后将分析结果转换为消息并推送到时序数据流进行输出。 |
使用说明
v1-RTSP源-物体检测-RTSP输出
版本说明
v1 版本的数据流包含以下环节：
- 从 RTSP 源拉取视频流数据，对视频流进行解码并形成一批视频帧，作为模型服务的输入。
- 使用模型服务检测视频帧中的特定对象（如行人、车辆等）并对检测到的对象进行标识。
- 将带有标识信息的视频帧进行编码形成视频流，然后推送到指定的 RTSP 服务器。
使用前提
在即将部署数据流实例的边缘节点上，您需要完成以下准备工作：
- 部署一个“物体检测”类型的模型服务。具体操作，请参见部署模型服务。
使用 v1 版本
说明
您可以使用官方模板下的版本来创建和部署数据流实例。具体操作，请参见创建和部署数据流实例。
以下仅罗列使用当前版本时您需要留意的配置。
基于数据流版本创建一个数据流实例。
- 模板：选择 官方模板/视频数据流/单源单输出官方模板。
- 版本：选择 v1-RTSP源-物体检测-RTSP输出。
- 节点：选择一个节点以部署该数据流实例。您选择的节点需要满足使用前提中的要求。
在数据流实例中进行数据流编排，为各个算子设置控制参数。
说明
关于算子控制参数的详细解释，请参见视频数据流算子。
算子
控制参数
类型
是否必须
说明
RTSP拉流带分析
location
String
是
RTSP 流的 URL。
identifier
String
是
RTSP 流的标识符。
latency
Integer
否
要缓存的毫秒数。取值范围：0~4294967295，默认值：2000。
roi-filters
N/A
否
绘制 ROI 区域。详见对象分析算子的说明。
line-crossings
N/A
否
绘制绊线。详见对象分析算子的说明。
h264解码器
无
N/A
否
无需设置。
批量合流
batch-size
Integer
是
批处理大小。取值范围：0~1024， 默认值：1。
enable-padding
Boolean
否
对视频帧进行缩放时，是否使用黑色边条填充以保持输入纵横比。默认：false。
height
Integer
是
输出的视频帧的高度，以像素为单位。取值范围：0~4294967295，默认值：720。
width
Integer
是
输出的视频帧的宽度，以像素为单位。取值范围：0~4294967295，默认值：1280。
物体检测
model-service
String
是
用于推理的模型服务。
input-process-mode
String
是
输入图像的处理方式。可选项：
- Full_Frame：全帧
- Clip_Object：剪辑对象
interval
Integer
否
指定连续跳过进行推理的批次数量。取值范围：0~2147483647，默认值：10。
对象跟踪
display-tracking-id
Boolean
否
是否在对象文本中显示跟踪 ID。默认值：true。
enable-batch-process
Boolean
否
是否启用跨多个流的批处理。默认值：true。
enable-past-frame
Boolean
否
是否启用将过去的帧轨迹添加到用户元信息中。默认值：false。
tracking-algorithm
String
是
跟踪算法。可选项：
- NVDCF_perf（默认）
- NVDCF_Max_Perf
- NVDCF_Accuracy
tracker-height
Integer
否
跟踪器应当操作的帧高度，以像素为单位。取值范围：0~4294967295，默认值：384。
tracker-width
Integer
否
跟踪器应当操作的帧宽度，以像素为单位。取值范围：0~4294967295，默认值：640。
结果绘制
display-bbox
Boolean
否
是否显示边界框。默认值：true。
display-clock
Boolean
否
是否显示时钟。默认值：false。
display-mask
Boolean
否
是否显示实例掩码。默认值：false。
display-text
Boolean
否
是否显示文字。默认值：true。
h264编码器
无
N/A
否
无需设置。
RTSP推流
location
String
是
要写入的 RTSP 流服务器的 URL。
latency
Integer
否
要缓存的毫秒数。取值范围：0~4294967295，默认值：2000。
protocols
String
是
推送视频流的协议。可选值：tcp、udp、http。默认值：tcp。
v2-RTMP源-物体检测-RTMP输出
版本说明
v2 版本的数据流包含以下环节：
- 从 RTMP 源拉取视频流数据，对视频流进行解码并形成一批视频帧，作为模型服务的输入。
- 使用模型服务检测视频帧中的特定对象（如行人、车辆等）并对检测到的对象进行标识。
- 将带有标识信息的视频帧进行编码形成视频流，然后推送到指定的 RTMP 服务器。
使用前提
在即将部署数据流实例的边缘节点上，您需要完成以下准备工作：
- 部署一个“物体检测”类型的模型服务。具体操作，请参见部署模型服务。
使用 v2 版本
说明
您可以使用官方模板下的版本来创建和部署数据流实例。具体操作，请参见创建和部署数据流实例。
以下仅罗列使用当前版本时您需要留意的配置。
基于数据流版本创建一个数据流实例。
- 模板：选择 官方模板/视频数据流/单源单输出官方模板。
- 版本：选择 v2-RTMP源-物体检测-RTMP输出。
- 节点：选择一个节点以部署该数据流实例。您选择的节点需要满足使用前提中的要求。
在数据流实例中进行数据流编排，为各个算子设置控制参数。
说明
关于算子控制参数的详细解释，请参见视频数据流算子。
算子
控制参数
类型
是否必须
说明
RTMP拉流带分析
location
String
是
RTMP 流的 URL。
identifier
String
是
RTMP 流的标识符。
roi-filters
N/A
否
绘制 ROI 区域。详见对象分析算子的说明。
line-crossings
N/A
否
绘制绊线。详见对象分析算子的说明。
h264解码器
无
N/A
否
无需设置。
批量合流
batch-size
Integer
是
批处理大小。取值范围：0~1024， 默认值：1。
enable-padding
Boolean
否
对视频帧进行缩放时，是否使用黑色边条填充以保持输入纵横比。默认：false。
height
Integer
是
输出的视频帧的高度，以像素为单位。取值范围：0~4294967295，默认值：720。
width
Integer
是
输出的视频帧的宽度，以像素为单位。取值范围：0~4294967295，默认值：1280。
物体检测
model-service
String
是
用于推理的模型服务。
input-process-mode
String
是
输入图像的处理方式。可选项：
- Full_Frame：全帧
- Clip_Object：剪辑对象
interval
Integer
否
指定连续跳过进行推理的批次数量。取值范围：0~2147483647，默认值：10。
对象跟踪
display-tracking-id
Boolean
否
是否在对象文本中显示跟踪 ID。默认值：true。
enable-batch-process
Boolean
否
是否启用跨多个流的批处理。默认值：true。
enable-past-frame
Boolean
否
是否启用将过去的帧轨迹添加到用户元信息中。默认值：false。
tracking-algorithm
String
是
跟踪算法。可选项：
- NVDCF_perf（默认）
- NVDCF_Max_Perf
- NVDCF_Accuracy
tracker-height
Integer
否
跟踪器应当操作的帧高度，以像素为单位。取值范围：0~4294967295，默认值：384。
tracker-width
Integer
否
跟踪器应当操作的帧宽度，以像素为单位。取值范围：0~4294967295，默认值：640。
结果绘制
display-bbox
Boolean
否
是否显示边界框。默认值：true。
display-clock
Boolean
否
是否显示时钟。默认值：false。
display-mask
Boolean
否
是否显示实例掩码。默认值：false。
display-text
Boolean
否
是否显示文字。默认值：true。
h264编码器
无
N/A
否
无需设置。
RTMP推流
location
String
是
要写入的 RTMP 流服务器的 URL。
v3-摄像头设备-物体检测-虚拟视频设备
版本说明
v3 版本的数据流包含以下环节：
- 从接入边缘节点的摄像头设备获取视频流数据，对视频流进行解码并形成一批视频帧，作为模型服务的输入。
- 使用模型服务检测视频帧中的特定对象（如行人、车辆等）并对检测到的对象进行标识。
- 将带有标识信息的视频帧进行编码形成视频流，然后推送到同一个边缘节点上的虚拟视频设备。
使用前提
在即将部署数据流实例的边缘节点上，您需要完成以下准备工作：
- 部署一个“物体检测”类型的模型服务。具体操作，请参见部署模型服务。
- 接入一个摄像头设备。
- 接入一个虚拟视频设备。
使用 v3 版本
说明
您可以使用官方模板下的版本来创建和部署数据流实例。具体操作，请参见创建和部署数据流实例。
以下仅罗列使用当前版本时您需要留意的配置。
基于数据流版本创建一个数据流实例。
- 模板：选择 官方模板/视频数据流/单源单输出官方模板。
- 版本：选择 v3-摄像头设备-物体检测-虚拟视频设备。
- 节点：选择一个节点以部署该数据流实例。您选择的节点需要满足使用前提中的要求。
在数据流实例中进行数据流编排，为各个算子设置控制参数。
说明
关于算子控制参数的详细解释，请参见视频数据流算子。
算子
控制参数
类型
是否必须
说明
摄像头设备带分析
device
String
是
从边缘节点已经接入的设备中选择一个摄像头设备。
device-tag
String
是
显示了已选择设备的标签。
identifier
String
是
摄像头设备的标识符。
latency
Integer
否
要缓存的毫秒数。取值范围：0~4294967295，默认值：2000。
roi-filters
N/A
否
绘制 ROI 区域。详见对象分析算子的说明。
line-crossings
N/A
否
绘制绊线。详见对象分析算子的说明。
h264解码器
无
N/A
否
无需设置。
批量合流
batch-size
Integer
是
批处理大小。取值范围：0~1024， 默认值：1。
enable-padding
Boolean
否
对视频帧进行缩放时，是否使用黑色边条填充以保持输入纵横比。默认：false。
height
Integer
是
输出的视频帧的高度，以像素为单位。取值范围：0~4294967295，默认值：720。
width
Integer
是
输出的视频帧的宽度，以像素为单位。取值范围：0~4294967295，默认值：1280。
推理服务
batch-size
Integer
是
最大批处理大小。取值范围：0~1024。默认值：0。
model-service
String
否
选择要使用的模型服务。
config-file-path
String
否
nvinferserver 实例的配置详情。
labelfile_path
String
否
config-file-path 中包含的 nvinferserver 实例的标签列表。
interval
Integer
否
在开始推理前要跳过的连续的批次数。取值范围：0~2147483647。默认值：0。
对象跟踪
display-tracking-id
Boolean
否
是否在对象文本中显示跟踪 ID。默认值：true。
enable-batch-process
Boolean
否
是否启用跨多个流的批处理。默认值：true。
enable-past-frame
Boolean
否
是否启用将过去的帧轨迹添加到用户元信息中。默认值：false。
tracking-algorithm
String
是
跟踪算法。可选项：
- NVDCF_perf（默认）
- NVDCF_Max_Perf
- NVDCF_Accuracy
tracker-height
Integer
否
跟踪器应当操作的帧高度，以像素为单位。取值范围：0~4294967295，默认值：384。
tracker-width
Integer
否
跟踪器应当操作的帧宽度，以像素为单位。取值范围：0~4294967295，默认值：640。
结果绘制
display-bbox
Boolean
否
是否显示边界框。默认值：true。
display-clock
Boolean
否
是否显示时钟。默认值：false。
display-mask
Boolean
否
是否显示实例掩码。默认值：false。
display-text
Boolean
否
是否显示文字。默认值：true。
h264编码器
无
N/A
否
无需设置。
虚拟视频设备
device
String
是
从边缘节点已经接入的设备中选择一个虚拟视频设备。
latency
Integer
否
要缓存的毫秒数。取值范围：0~4294967295，默认值：2000。
v4-RTSP源-物体检测-消息转换-虚拟时序设备
版本说明
v4 版本的数据流包含以下环节：
- 从 RTSP 源拉取视频流数据，对视频流进行解码并形成一批视频帧，作为模型服务的输入。
- 使用模型服务检测视频帧中的特定对象（如行人、车辆等）。
- 将带有检测信息的结果转换为 JSON 格式的消息元数据，然后推送到同一个边缘节点上的虚拟时序设备。
使用前提
在即将部署数据流实例的边缘节点上，您需要完成以下准备工作：
- 部署一个“物体检测”类型的模型服务。具体操作，请参见部署模型服务。
- 接入一个虚拟时序设备。
使用 v4 版本
说明
您可以使用官方模板下的版本来创建和部署数据流实例。具体操作，请参见创建和部署数据流实例。
以下仅罗列使用当前版本时您需要留意的配置。
基于数据流版本创建一个数据流实例。
- 模板：选择 官方模板/视频数据流/单源单输出官方模板。
- 版本：选择 v4-RTSP源-物体检测-消息转换-虚拟时序设备。
- 节点：选择一个节点以部署该数据流实例。您选择的节点需要满足使用前提中的要求。
在数据流实例中进行数据流编排，为各个算子设置控制参数。
说明
关于算子控制参数的详细解释，请参见视频数据流算子。
算子
控制参数
类型
是否必须
说明
RTSP拉流带分析
location
String
是
RTSP 流的 URL。
identifier
String
是
RTSP 流的标识符。
latency
Integer
否
要缓存的毫秒数。取值范围：0~4294967295，默认值：2000。
roi-filters
N/A
否
绘制 ROI 区域。详见对象分析算子的说明。
line-crossings
N/A
否
绘制绊线。详见对象分析算子的说明。
h265解码器
无
N/A
否
无需设置。
批量合流
batch-size
Integer
是
批处理大小。取值范围：0~1024， 默认值：1。
enable-padding
Boolean
否
对视频帧进行缩放时，是否使用黑色边条填充以保持输入纵横比。默认：false。
height
Integer
是
输出的视频帧的高度，以像素为单位。取值范围：0~4294967295，默认值：720。
width
Integer
是
输出的视频帧的宽度，以像素为单位。取值范围：0~4294967295，默认值：1280。
物体检测
model-service
String
是
用于推理的模型服务。
input-process-mode
String
是
输入图像的处理方式。可选项：
- Full_Frame：全帧
- Clip_Object：剪辑对象
interval
Integer
否
指定连续跳过进行推理的批次数量。取值范围：0~2147483647，默认值：10。
对象跟踪
display-tracking-id
Boolean
否
是否在对象文本中显示跟踪 ID。默认值：true。
enable-batch-process
Boolean
否
是否启用跨多个流的批处理。默认值：true。
enable-past-frame
Boolean
否
是否启用将过去的帧轨迹添加到用户元信息中。默认值：false。
tracking-algorithm
String
是
跟踪算法。可选项：
- NVDCF_perf（默认）
- NVDCF_Max_Perf
- NVDCF_Accuracy
tracker-height
Integer
否
跟踪器应当操作的帧高度，以像素为单位。取值范围：0~4294967295，默认值：384。
tracker-width
Integer
否
跟踪器应当操作的帧宽度，以像素为单位。取值范围：0~4294967295，默认值：640。
消息转换
frame-interval
Integer
否
生成有效载荷的帧间隔。取值范围：0~4294967295，默认值：30。
conditions
String
否
actions
Array
否
条件满足时需要执行的操作列表。可选项：
- send：发送消息。
- not send：不发送消息。
send_image
Boolean
否
是否发送图像数据。默认值：true。
enable_extra_info
Boolean
否
是否发送额外信息。默认值：true。
虚拟时序设备
device
String
是
从边缘节点已经接入的设备中选择一个虚拟时序设备。
v5-RTSP源-物体检测-事件推送
版本说明
v5 版本的数据流包含以下环节：
- 从 RTSP 源拉取视频流数据，对视频流进行解码并形成一批视频帧，作为模型服务的输入。
- 使用模型服务检测视频帧中的特定对象（如行人、车辆等）。
- 将带有分析信息的结果转换为 JSON 格式的消息元数据，然后推送到边缘智能控制台的数据流事件中心。
使用前提
在即将部署数据流实例的边缘节点上，您需要完成以下准备工作：
使用 v5 版本
说明
您可以使用官方模板下的版本来创建和部署数据流实例。具体操作，请参见创建和部署数据流实例。
以下仅罗列使用当前版本时您需要留意的配置。
基于数据流版本创建一个数据流实例。
- 模板：选择 官方模板/视频数据流/单源单输出官方模板。
- 版本：选择 v5-RTSP源-物体检测-事件推送。
- 节点：选择一个节点以部署该数据流实例。您选择的节点需要满足使用前提中的要求。
在数据流实例中进行数据流编排，为各个算子设置控制参数。
说明
关于算子控制参数的详细解释，请参见视频数据流算子。
算子
控制参数
类型
是否必须
说明
RTSP拉流带分析
location
String
是
RTSP 流的 URL。
identifier
String
是
RTSP 流的标识符。
latency
Integer
否
要缓存的毫秒数。取值范围：0~4294967295，默认值：2000。
roi-filters
N/A
否
绘制 ROI 区域。详见对象分析算子的说明。
line-crossings
N/A
否
绘制绊线。详见对象分析算子的说明。
h264解码器
无
N/A
否
无需设置。
批量合流
batch-size
Integer
是
批处理大小。取值范围：0~1024， 默认值：1。
enable-padding
Boolean
否
对视频帧进行缩放时，是否使用黑色边条填充以保持输入纵横比。默认：false。
height
Integer
是
输出的视频帧的高度，以像素为单位。取值范围：0~4294967295，默认值：720。
width
Integer
是
输出的视频帧的宽度，以像素为单位。取值范围：0~4294967295，默认值：1280。
物体检测
model-service
String
是
用于推理的模型服务。
input-process-mode
String
是
输入图像的处理方式。可选项：
- Full_Frame：全帧
- Clip_Object：剪辑对象
interval
Integer
否
指定连续跳过进行推理的批次数量。取值范围：0~2147483647，默认值：10。
对象跟踪
display-tracking-id
Boolean
否
是否在对象文本中显示跟踪 ID。默认值：true。
enable-batch-process
Boolean
否
是否启用跨多个流的批处理。默认值：true。
enable-past-frame
Boolean
否
是否启用将过去的帧轨迹添加到用户元信息中。默认值：false。
tracking-algorithm
String
是
跟踪算法。可选项：
- NVDCF_perf（默认）
- NVDCF_Max_Perf
- NVDCF_Accuracy
tracker-height
Integer
否
跟踪器应当操作的帧高度，以像素为单位。取值范围：0~4294967295，默认值：384。
tracker-width
Integer
否
跟踪器应当操作的帧宽度，以像素为单位。取值范围：0~4294967295，默认值：640。
结果绘制
display-bbox
Boolean
否
是否显示边界框。默认值：true。
display-clock
Boolean
否
是否显示时钟。默认值：false。
display-mask
Boolean
否
是否显示实例掩码。默认值：false。
display-text
Boolean
否
是否显示文字。默认值：true。
消息转换
frame-interval
Integer
否
生成有效载荷的帧间隔。取值范围：0~4294967295，默认值：30。
conditions
String
否
actions
Array
否
条件满足时需要执行的操作列表。可选项：
- send：发送消息。
- not send：不发送消息。
send_image
Boolean
否
是否发送图像数据。默认值：true。
enable_extra_info
Boolean
否
是否发送额外信息。默认值：true。
事件推送
无
N/A
否
无需设置。
v6-RTSP源-物体检测-图像分类-Kafka
版本说明
v6 版本的数据流包含以下环节：
- 从 RTSP 源拉取视频流数据，对视频流进行解码并形成一批视频帧，作为模型服务的输入。
- 使用模型服务检测视频帧中的特定对象（如行人、车辆等），然后使用另一个模型服务检测目标对象是否有特定特征（如行人是否佩戴口罩或在吸烟、车辆的类型等）。
- 将带有分析信息的结果转换为 JSON 格式的消息元数据，然后推送到 Kafka 服务器。
使用前提
- 您已获取 Kafka 服务器的地址。
- 在即将部署数据流实例的边缘节点上，您需要完成以下准备工作：
- 部署一个“物体检测”类型的模型服务。
- 部署一个“图像分类”类型的模型服务。
具体操作，请参见部署模型服务。
使用 v6 版本
说明
您可以使用官方模板下的版本来创建和部署数据流实例。具体操作，请参见创建和部署数据流实例。
以下仅罗列使用当前版本时您需要留意的配置。
基于数据流版本创建一个数据流实例。
- 模板：选择 官方模板/视频数据流/单源单输出官方模板。
- 版本：选择 v6-RTSP源-物体检测-图像分类-Kafka。
- 节点：选择一个节点以部署该数据流实例。您选择的节点需要满足使用前提中的要求。
在数据流实例中进行数据流编排，为各个算子设置控制参数。
说明
关于算子控制参数的详细解释，请参见视频数据流算子。
算子
控制参数
类型
是否必须
说明
RTSP拉流带分析
location
String
是
RTSP 流的 URL。
identifier
String
是
RTSP 流的标识符。
latency
Integer
否
要缓存的毫秒数。取值范围：0~4294967295，默认值：2000。
roi-filters
N/A
否
绘制 ROI 区域。详见对象分析算子的说明。
line-crossings
N/A
否
绘制绊线。详见对象分析算子的说明。
h264解码器
无
N/A
否
无需设置。
批量合流
batch-size
Integer
是
批处理大小。取值范围：0~1024， 默认值：1。
enable-padding
Boolean
否
对视频帧进行缩放时，是否使用黑色边条填充以保持输入纵横比。默认：false。
height
Integer
是
输出的视频帧的高度，以像素为单位。取值范围：0~4294967295，默认值：720。
width
Integer
是
输出的视频帧的宽度，以像素为单位。取值范围：0~4294967295，默认值：1280。
物体检测
model-service
String
是
用于推理的模型服务。
input-process-mode
String
是
输入图像的处理方式。可选项：
- Full_Frame（默认）：全帧
- Clip_Object：剪辑对象
建议将该参数设置为 Full_Frame，表示对整个视频帧进行处理，检测其中的目标。
interval
Integer
否
指定连续跳过进行推理的批次数量。取值范围：0~2147483647，默认值：10。
对象跟踪
display-tracking-id
Boolean
否
是否在对象文本中显示跟踪 ID。默认值：true。
enable-batch-process
Boolean
否
是否启用跨多个流的批处理。默认值：true。
enable-past-frame
Boolean
否
是否启用将过去的帧轨迹添加到用户元信息中。默认值：false。
tracking-algorithm
String
是
跟踪算法。可选项：
- NVDCF_perf（默认）
- NVDCF_Max_Perf
- NVDCF_Accuracy
tracker-height
Integer
否
跟踪器应当操作的帧高度，以像素为单位。取值范围：0~4294967295，默认值：384。
tracker-width
Integer
否
跟踪器应当操作的帧宽度，以像素为单位。取值范围：0~4294967295，默认值：640。
图像分类
model-service
String
是
用于图像分类的模型服务。
input-process-mode
String
是
输入图像的处理方式。可选项：
- Full_Frame：全帧
- Clip_Object（默认）：剪辑对象
建议将该参数设置为 Clip_Object，表示对视频帧中检测到的目标对象（所在区域）进行处理，为目标对象分类。
interval
Integer
否
指定连续跳过进行推理的批次数量。取值范围：0~2147483647，默认值：10。
结果绘制
display-bbox
Boolean
否
是否显示边界框。默认值：true。
display-clock
Boolean
否
是否显示时钟。默认值：false。
display-mask
Boolean
否
是否显示实例掩码。默认值：false。
display-text
Boolean
否
是否显示文字。默认值：true。
消息转换
frame-interval
Integer
否
生成有效载荷的帧间隔。取值范围：0~4294967295，默认值：30。
conditions
String
否
actions
Array
否
条件满足时需要执行的操作列表。可选项：
- send：发送消息。
- not send：不发送消息。
send_image
Boolean
否
是否发送图像数据。默认值：true。
enable_extra_info
Boolean
否
是否发送额外信息。默认值：true。
Kafka消息队列
kafka-brokers
String
否
Kafka 服务器的访问地址（包含端口号）。格式：
<address>:<port>。topic
String
否
消息的主题。
v7-RTSP源-推理服务-事件推送
版本说明
v7 版本的数据流包含以下环节：
- 从 RTSP 源拉取视频流数据，对视频流进行解码并形成一批视频帧，作为模型服务的输入。
- 使用模型服务检测视频帧中的特定对象（如行人、车辆等）。
- 将带有分析信息的结果转换为 JSON 格式的消息元数据，然后推送到边缘智能控制台的数据流事件中心。
使用前提
在即将部署数据流实例的边缘节点上，您需要完成以下准备工作：
使用 v7 版本
说明
您可以使用官方模板下的版本来创建和部署数据流实例。具体操作，请参见创建和部署数据流实例。
以下仅罗列使用当前版本时您需要留意的配置。
基于数据流版本创建一个数据流实例。
- 模板：选择 官方模板/视频数据流/单源单输出官方模板。
- 版本：选择 v7-RTSP源-推理服务-事件推送。
- 节点：选择一个节点以部署该数据流实例。您选择的节点需要满足使用前提中的要求。
在数据流实例中进行数据流编排，为各个算子设置控制参数。
说明
关于算子控制参数的详细解释，请参见视频数据流算子。
算子
控制参数
类型
是否必须
说明
RTSP拉流带分析
location
String
是
RTSP 流的 URL。
identifier
String
是
RTSP 流的标识符。
latency
Integer
否
要缓存的毫秒数。取值范围：0~4294967295，默认值：2000。
roi-filters
N/A
否
绘制 ROI 区域。详见对象分析算子的说明。
line-crossings
N/A
否
绘制绊线。详见对象分析算子的说明。
h264解码器
无
N/A
否
无需设置。
批量合流
batch-size
Integer
是
批处理大小。取值范围：0~1024， 默认值：1。
enable-padding
Boolean
否
对视频帧进行缩放时，是否使用黑色边条填充以保持输入纵横比。默认：false。
height
Integer
是
输出的视频帧的高度，以像素为单位。取值范围：0~4294967295，默认值：720。
width
Integer
是
输出的视频帧的宽度，以像素为单位。取值范围：0~4294967295，默认值：1280。
推理服务
batch-size
Integer
是
最大批处理大小。取值范围：0~1024。默认值：0。
model-service
String
否
选择要使用的模型服务。
config-file-path
String
否
nvinferserver 实例的配置详情。
labelfile_path
String
否
config-file-path 中包含的 nvinferserver 实例的标签列表。
interval
Integer
否
在开始推理前要跳过的连续的批次数。取值范围：0~2147483647。默认值：0。
对象跟踪
display-tracking-id
Boolean
否
是否在对象文本中显示跟踪 ID。默认值：true。
enable-batch-process
Boolean
否
是否启用跨多个流的批处理。默认值：true。
enable-past-frame
Boolean
否
是否启用将过去的帧轨迹添加到用户元信息中。默认值：false。
tracking-algorithm
String
是
跟踪算法。可选项：
- NVDCF_perf（默认）
- NVDCF_Max_Perf
- NVDCF_Accuracy
tracker-height
Integer
否
跟踪器应当操作的帧高度，以像素为单位。取值范围：0~4294967295，默认值：384。
tracker-width
Integer
否
跟踪器应当操作的帧宽度，以像素为单位。取值范围：0~4294967295，默认值：640。
结果绘制
display-bbox
Boolean
否
是否显示边界框。默认值：true。
display-clock
Boolean
否
是否显示时钟。默认值：false。
display-mask
Boolean
否
是否显示实例掩码。默认值：false。
display-text
Boolean
否
是否显示文字。默认值：true。
消息转换
frame-interval
Integer
否
生成有效载荷的帧间隔。取值范围：0~4294967295，默认值：30。
conditions
String
否
actions
Array
否
条件满足时需要执行的操作列表。可选项：
- send：发送消息。
- not send：不发送消息。
send_image
Boolean
否
是否发送图像数据。默认值：true。
enable_extra_info
Boolean
否
是否发送额外信息。默认值：true。
事件推送
无
N/A
否
无需设置。
v8-RTSP源-物体检测-ekuiper推送
版本说明
v8 版本的数据流包含以下环节：
- 从 RTSP 源拉取视频流数据，对视频流进行解码并形成一批视频帧，作为模型服务的输入。
- 使用模型服务检测视频帧中的特定对象（如行人、车辆等）。
- 将带有分析信息的结果转换为 JSON 格式的消息元数据，然后推送到同一个边缘节点上的时序数据流实例进行处理。
使用前提
在即将部署数据流实例的边缘节点上，您需要完成以下准备工作：
使用 v8 版本
说明
您可以使用官方模板下的版本来创建和部署数据流实例。具体操作，请参见创建和部署数据流实例。
以下仅罗列使用当前版本时您需要留意的配置。
基于数据流版本创建一个数据流实例。
- 模板：选择 官方模板/视频数据流/单源单输出官方模板。
- 版本：选择 v8-RTSP源-物体检测-ekuiper推送。
- 节点：选择一个节点以部署该数据流实例。您选择的节点需要满足使用前提中的要求。
在数据流实例中进行数据流编排，为各个算子设置控制参数。
说明
关于算子控制参数的详细解释，请参见视频数据流算子。
算子
控制参数
类型
是否必须
说明
RTSP拉流带分析
location
String
是
RTSP 流的 URL。
identifier
String
是
RTSP 流的标识符。
latency
Integer
否
要缓存的毫秒数。取值范围：0~4294967295，默认值：2000。
roi-filters
N/A
否
绘制 ROI 区域。详见对象分析算子的说明。
line-crossings
N/A
否
绘制绊线。详见对象分析算子的说明。
h264解码器
无
N/A
否
无需设置。
批量合流
batch-size
Integer
是
批处理大小。取值范围：0~1024， 默认值：1。
enable-padding
Boolean
否
对视频帧进行缩放时，是否使用黑色边条填充以保持输入纵横比。默认：false。
height
Integer
是
输出的视频帧的高度，以像素为单位。取值范围：0~4294967295，默认值：720。
width
Integer
是
输出的视频帧的宽度，以像素为单位。取值范围：0~4294967295，默认值：1280。
物体检测
model-service
String
是
用于推理的模型服务。
input-process-mode
String
是
输入图像的处理方式。可选项：
- Full_Frame：全帧
- Clip_Object：剪辑对象
interval
Integer
否
指定连续跳过进行推理的批次数量。取值范围：0~2147483647，默认值：10。
对象跟踪
display-tracking-id
Boolean
否
是否在对象文本中显示跟踪 ID。默认值：true。
enable-batch-process
Boolean
否
是否启用跨多个流的批处理。默认值：true。
enable-past-frame
Boolean
否
是否启用将过去的帧轨迹添加到用户元信息中。默认值：false。
tracking-algorithm
String
是
跟踪算法。可选项：
- NVDCF_perf（默认）
- NVDCF_Max_Perf
- NVDCF_Accuracy
tracker-height
Integer
否
跟踪器应当操作的帧高度，以像素为单位。取值范围：0~4294967295，默认值：384。
tracker-width
Integer
否
跟踪器应当操作的帧宽度，以像素为单位。取值范围：0~4294967295，默认值：640。
结果绘制
display-bbox
Boolean
否
是否显示边界框。默认值：true。
display-clock
Boolean
否
是否显示时钟。默认值：false。
display-mask
Boolean
否
是否显示实例掩码。默认值：false。
display-text
Boolean
否
是否显示文字。默认值：true。
消息转换
frame-interval
Integer
否
生成有效载荷的帧间隔。取值范围：0~4294967295，默认值：30。
conditions
String
否
actions
Array
否
条件满足时需要执行的操作列表。可选项：
- send：发送消息。
- not send：不发送消息。
send_image
Boolean
否
是否发送图像数据。默认值：true。
enable_extra_info
Boolean
否
是否发送额外信息。默认值：true。
Ekuiper推送
无
N/A
否
无需设置。
最佳实践
如果直接使用官方模板创建数据流实例，您将无法修改数据流的结构。而在实际使用过程中，官方模板版本中的数据流结构可能并不适合您的业务需求。这种情况下，您可以按如下方式来使用官方模板：
- 复制官方模板生成一个新的自定义模板。（新的自定义模板包含官方模板下的所有版本。）
- 在自定义模板中，找到适合您场景的版本，然后通过数据流编排，修改版本的数据流（如增删算子等）。
- 使用自定义模板创建数据流实例。