FVS监控视频组件

适用场景：安装了「FineVis数据可视化」插件的用户，可参考本文了解 FVS 模板的相关功能。

1.1 版本

1.2 功能简介

监控视频组件，可实时在线展示监控视频画面。

注：本文仅为大家介绍监控视频组件特有功能，其他属性不赘述。

• 「监控视频」组件不支持 FVS组件交互属性 。 
  

• 组件动画请参见：FVS组件动画 。

• 组件属性请参见：FVS组件样式属性 。

2.1 功能入口

点击组件区「其他>媒体>监控视频」，将组件添加到画布中。在右侧「内容」配置面板设置监控地址等内容。如下图所示：

2.2 功能说明

2.2.1 监控地址

直接输入监控地址 URL，V1.16.1 及之后版本，还支持在 URL 中插入公式实现动态展示监控视频。

V1.17.0 版本之前，监控地址仅支持 HLS 协议的视频流，形如 http://XXX.m3u8 。

V1.17.0 及之后版本，支持 HLS 、RTSP、RTMP 三种协议视频流，需通过选择「视频类型」解析不同协议视频。

2.2.2 视频类型

支持选择「视频类型」为 HLS 、RTSP、RTMP。选择 RTSP 或 RTMP 时，需安装「FVS流媒体处理依赖插件」 。

若未安装，则提示安装插件，点击「去安装」，可跳转至插件管理。

• 点击下载插件：FVS流媒体处理依赖插件

• 设计器插件安装方法参照：设计器插件管理

• 服务器安装插件方法参照：服务器插件管理

若未安装「FVS流媒体处理依赖插件」，预览配置了 RTSP 或 RTMP 监控视频的模板，会提示“无法找到此视频兼容的源”。如下图所示：

注：配置监控地址后，画布框中不实时显示监控画面，需预览模板方可查看。

2.2.3 填充方式

V2.9.0.4 及之后版本，监控视频可选择两种填充方式：

• 适应：视频画面宽高比不变，等比拉大/缩小视频，确保宽/高充满组件即可

• 拉伸：视频宽度拉伸至组件宽度，视频高度拉伸至组件高度

2.2.4 工具栏

支持设置是否显示视频工具栏，默认不显示。

2.2.5 初始音量

支持配置监控视频的音量，默认音量为 0。

本文示例主要展示如何通过 下拉框控件 展示不同的监控视频。

3.1 新建模板

点击设计器左上角「文件>新建可视化看板」，创建空白看板，可自定义名称和尺寸。如下图所示：

3.2 设置下拉框控件

1）将「下拉框控件」拖入到画布中，设置「绑定参数」为 a ，用于设置监控地址并联动监控视频组件。

2）设置控件的数据字典为自定义，实际值输入示例监控地址，显示值可自定义。

示例地址来源于 直播中国 ：https://gctxyc.liveplay.myqcloud.com/gc/sxzl_1_md.m3u8  、 https://gctxyc.liveplay.myqcloud.com/gc/yxhcyz_1/index.m3u8 。

注：地址来源于网络，随时可能失效，建议您自行查找可用资源，或使用实际地址测试。

设置完成后将默认值设置为其中一个监控地址即可。如下图所示：

3.3 设置监控视频组件

点击「媒体>监控视频」，在页面中新增一个「监控视频件」，在监控地址处点击「插入公式」，输入 $a 。如下图所示：

注：若 URL 只有部分内容不同，也可以只将不同的部分用公式替代即可。例如：https://gctxyc.liveplay.myqcloud.com/gc/公式1.m3u8 。

3.4 效果预览

3.4.1 PC 端

点击右上角「保存」，再点击「预览」，效果如下图所示：

3.4.2 移动端

预览方式请参考 FVS移动端预览 ，效果如下图所示：

点击下载模板：动态展示监控视频示例.fvs

5.1 萤石摄像头监控地址

若用户使用萤石摄像头，可直接登录 萤石开放平台，获取 hls 协议的直播地址。详情请参见：萤石直播地址。  

5.2 监控视频无法播放排查步骤

上文提到若未安装「FineVis流媒体处理依赖」插件，预览配置了 RTSP 或 RTMP 监控视频的模板，会提示“无法找到此视频兼容的源”。

但若安装了该插件，仍提示“无法找到此视频兼容的源”，则还可能与监控视频本身或网络环境有关系。

可按以下排查步骤进行检查：

1）使用 vlc 能否播放成功：vlc 下载地址：https://www.videolan.org/index.an.html 。

下载并安装后，点击左上角「媒体>打开网络串流」，输入监控视频链接，点击「播放」测试能否播放成功。

2）检查服务器所在地址与监控视频服务器所在地址 telnet 能否成功。

例如：

• telnet 成功

• telnet 不成功

5.3 监控视频数量限制

监控视频使用 RTSP 或 RTMP 协议时，需注意组件数量限制：

1）V2.5.1 之前的版本中，一个页面最多不超过 6 个监控视频组件，否则会导致视频无法播放。

2）升级 FVS 插件至 V2.5.1 及之后版本且「FineVis流媒体处理依赖」插件至 V1.9 及之后版本；并参考 fine_conf_entity可视化配置 修改 WebSocketConfig.randomSession 参数值为 true 后，页面支持的监控视频组件数量增多，但具体数量和 视频流配置、服务器性能 以及 带宽 有关。

• 帧率越小、分辨率越小、服务器性能越高、带宽越高，支持同时播放的视频个数越多。

• 参考测试环境及效果如下表所示：

5.4 监控视频播放卡顿

原因分析

预览模板，监控视频播放卡顿 ，可能是监控视频的音频无法解析而导致的。

解决方案

在 designer.vmoptions 文件中添加启动参数 -Dplugin.wysiwyg.media.audio.no=true 。

该参数的作用是：配置不解析音频直接播放。添加后需重启工程。

注：需升级「FineVis流媒体处理依赖」插件至 V2.0 及之后版本。

文件所在路径如下图所示：

添加参数如下图所示：