FVS Surveillance Video Component

This document is applicable to users who have installed the FineVis Data Visualization plugin to learn operations related to FVS dashboard.

Version

Function Description

In the surveillance video component, the live surveillance video can be displayed.

Note:

This document introduces only the unique functions of the surveillance video component.

The surveillance video component does not support FVS Component Interaction Attribute.

For details about the component animation, see FVS Cross-page Component Animation.

For details about the component attribute, see FVS Component Style and Attribute.

Function Entry

Choose Media > Surveillance Video in the component area and drag the component to the canvas. Set the surveillance address and other items in the Content configuration panel on the right side.

Function Description

1. Surveillance Address

Directly enter the surveillance video URL. In the plugin V1.16.1 and later versions, formulas can be inserted in the URL for dynamic surveillance videos.

In the plugin of versions earlier than V1.17.0, the surveillance address only supports HLS streaming protocol in http://XXX.m3u8 format.

In the plugin V1.17.0 and later versions, three types of streaming protocols are supported: HLS, RTSP, and RTMP. You need to select the corresponding Video Type to parse videos using different protocols.

2. Video Type

HLS, RTSP, or RTMP can be selected as Video Type. If RTSP or RTMP is selected, a dialog box indicating that whether you want to install the FineVis stream processing plugin will prompt. (You are not allowed to select RTSP or RTMP if you do not install the plugin.) 

Click To install to jump to the plugin management page.

If the FVS streaming processing dependency plugin is not installed, an error message is displayed, indicating that no compatible source for this video was found if you preview a template with a RTSP or RTMP surveillance video.

Note:

 After the surveillance address is set, the live surveillance video is not displayed on canvas. You need to preview the template to view it.

3. Toolbar

In the plugin V1.17.0 and later versions, you can set whether to display the video toolbar, which is not displayed by default.

4. Initial Volume

The volume of the surveillance video can be set, which is set to 0 by default.

The following sections introduce how to display different surveillance videos through a dropdown box widget.

Creating a Template

Choose File > New FineVis Visualization Dashboard in the upper-left corner of the designer, and create a dashboard. You can customize the name and size.

Setting the Dropdown Box Widget

1. Drag a Dropdown Box widget to the canvas and rename it as a (the parameter), which is used to set the surveillance address and link the surveillance video component.

2. Set the widget's Data Dictionary to Custom, input the surveillance address as the actual value, and customize the display value. After the setting, set the default value to one of the inputted surveillance addresses.

Setting the Surveillance Video Component

Choose Media > Surveillance Video to add a surveillance video component on the page, click Insert Formula in the surveillance address, and enter $a.

Note:

If only part of the URL is different, you can replace the different part with a formula. For example, https://gctxyc.liveplay.myqcloud.com/gc/formula1.m3u8.

Demonstration

Click Save in the top right corner, and then click Preview.

1. On PC

Click Save in the upper-right corner, and then click Preview. The following figure shows the effect.

2. On Mobile Terminals

For details, see FVS Mobile Attribute. The dashboard is shown in the following figure.

You can download the template: Dynamic Display of Surveillance Video.fvs

Troubleshooting the Playback Failure

If the FineVis streaming media processing plugin is not installed, an error message is displayed, indicating that no compatible source for this video was found if you preview a template with a RTSP or RTMP surveillance video.

If the error message is still displayed after you install the plugin, the problem may arise from the surveillance video itself or the network environment.

You can perform the following troubleshooting steps:

1. Try playing the surveillance video with the VLC media player to see if the videos can be played successfully. (Click here to download: https://www.videolan.org/index.an.html.)

After you download and install the player, choose Media > Open Network Stream, enter the URL of the surveillance video, and click Play to see if the video can be played successfully.

2. Check if a successful connection between the server IP and the surveillance video server IP can be established via telnet.

The connection has been established.

The connection failed.

Surveillance Video Quantity Limit

When using RTSP or RTMP protocols for surveillance videos, you need to pay attention to the quantity limit of the Surveillance Video component:

1. If the FineVis Data Visualization plugin is in a version before V2.5.1, one single page can only be placed with a maximum of six components, otherwise the videos are unable to play.

2. The quantity limit of the component will be removed if you upgrade the FineVis Data Visualization plugin to version 2.5.1 or later, as well as the FineVis streaming media processing dependency plugin to version 1.9 or later and modify the value of the WebSocketConfig.randomSession parameter to true by referring to FINE_CONF_ENTITY Visual Configuration.