单源多输出官方模板

本文介绍了单源多输出官方数据流模板。单源多输出模板适用于视频数据流，表示从单个输入节点获取视频流，经过一系列处理后，将处理结果复制多份，分别推送到多个输出节点。

基本信息

您可以在边缘智能控制台的官方模板列表访问本模板。下图展示了本模板的基本信息。

版本列表

本模板提供如下可用版本。

使用说明

v1-RTSP源-物体检测-多个输出-事件推送和RTSP输出

版本说明
v1 版本的数据流包含以下环节：

1. 从 RTSP 源拉取视频流数据，对视频流进行解码并形成一批视频帧，作为模型服务的输入。
2. 使用模型服务检测视频帧中的特定对象（如行人、车辆等），并分析目标是否有在 ROI 区域出现或跨越边界线的行为。
3. 将带有分析信息的结果复制成两份，分别按以下方式进行输出：
   • 一份转换为 JSON 格式的消息元数据，然后推送到边缘智能控制台的数据流事件中心。
   • 一份进行编码形成视频流，然后推送到指定的 RTSP 服务器。

使用前提
在即将部署数据流实例的一体机上，您需要完成以下准备工作：

• 部署一个“物体检测”类型的模型服务。相关操作，请参见部署模型服务。
• 为一体机开启“状态监控”功能。相关操作，请参见开启状态监控。

使用 v1 版本

1. 基于数据流版本创建一个数据流实例。

   • 模板：选择 官方模板/视频数据流/单源多输出官方模板。
   • 版本：选择 v1-RTSP源-物体检测-多个输出-事件推送和RTSP输出。
   • 一体机：选择一个一体机以部署该数据流实例。您选择的一体机需要满足使用前提中的要求。

2. 在数据流实例中进行数据流编排，为各个节点设置控制参数。

   说明

   关于节点控制参数的详细解释，请参见视频数据流节点。

   节点	控制参数	类型	是否必须	说明
   RTSP拉流	location	String	是	RTSP 流的 URL。
   	latency	Integer	否	要缓存的毫秒数。取值范围：0~4294967295，默认值：2000。
   	identifier	String	是	RTSP 流的标识符。
   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。
   对象分析	roi-filters	N/A	否	绘制 ROI 区域。更多信息，请参见对象分析节点说明。
   	line-crossings	N/A	否	绘制绊线。更多信息，请参见对象分析节点说明。
   结果绘制	display-bbox	Boolean	否	是否显示边界框。默认值：true。
   	display-clock	Boolean	否	是否显示时钟。默认值：false。
   	display-mask	Boolean	否	是否显示实例掩码。默认值：false。
   	display-text	Boolean	否	是否显示文字。默认值：true。
   流分支	无	N/A	否	无需设置。
   消息转换	frame-interval	Integer	否	生成有效载荷的帧间隔。取值范围：0~4294967295，默认值：30。
   	conditions	String	否	使用 JSON Path 语法，针对消息元数据设置过滤条件。关于消息元数据的参数结构，请参见数据流事件。
   	actions	Array	否	条件满足时需要执行的操作列表。可选项： send：发送消息。 not send：不发送消息。
   	send_image	Boolean	否	是否发送图像数据。默认值：true。
   	enable_extra_info	Boolean	否	是否发送额外信息。默认值：true。
   事件推送	无	N/A	否	无需设置。
   h264编码器	无	N/A	否	无需设置。
   RTSP推流	location	String	是	要写入的 RTSP 流服务器的 URL。
   	latency	Integer	否	要缓存的毫秒数。取值范围：0~4294967295，默认值：2000。
   	protocols	String	是	推送视频流的协议。可选值：tcp、udp、http。默认值：tcp。

最佳实践

如果直接使用官方模板创建数据流实例，您将无法修改数据流的结构。而在实际使用过程中，官方模板版本中的数据流结构可能并不适合您的业务需求。这种情况下，您可以按如下方式来使用官方模板：

1. 复制官方模板生成一个新的自定义模板。（新的自定义模板包含官方模板下的所有版本。）
2. 在自定义模板中，找到适合您场景的版本，然后通过数据流编排，修改版本的数据流（如增删节点等）。
3. 使用自定义模板创建数据流实例。

示例

针对单源多输出官方模板 v1 版本，您可以将 RTSP推流 节点替换成 虚拟视频设备、RTMP推流 节点，或者将 事件推送 节点替换成 虚拟时序设备、Kafka消息队列、Redis消息队列、Ekuiper推送 等节点。