*Video Tagging
- Tom Polman
- Martijn Friggen
How To Article | HTA-20201130-TP-06 VDG Sense | Operator | Data export & securing  |  |
Normally the system will delete the oldest video and metadata to make place for new video. When deleted this video is lost. To prevent this in case something happens, the video (and metadata) can be tagged so it will not be deleted.
Video tagging can be done in three methods. The first method is using the macro action “Tag video Start” & “Tag video stop”. This allows for automatic tagging when an event occurs or manually when assigned to a layout button. The second method is using the API function “executeAction” with the actions server.tagVideoStart and server.tagVideoStop. Using the API function allows for retrospectively video tagging up to 24 hours using the pretime parameter. The third method is using the Timeline panel. This allows an operator to retrospectively video tag any recorded data manually.
While the systems becomes full with tagged video several “storage full” SystemEvents will be fired so the client can be notified of this. Events will be fired on 30, 60, 90 and 100 percent of locked storage space.
Tagged video always need to be manually released using the Sense Client or the API function releaseVideoTag.
Method 1: Macro action
To create a video tag using the macro engine, create either a Server or a Viewer macro with a signal of your choice. Finally, create as the macro action:
Viewer macro:
Server macro:
Method 2: Execute action
How to use the API function for video tagging can be found in the API documentation
Method 3: Timeline (2.5.12+)
In 2.5.12, it’s possible to tag video using the Timeline panel. The advantage of using the timeline is that previously recorded data can still be tagged. This is contrary of method 1 & 2, which will tag live video.
To create a video tag with the timeline, open a layout containing a video playback panel and the timeline. Select the range which you would like to tag in the time ribbon, and click the “Video Tag” button to open the ‘Add Video Tag’-dialog.
Start Date/Time
The starting date/time of the video tag
End Date/Time
The ending date/time of the video tag
Title
An optional title to identify the tagged video
Comment
An optional comment to identify the tagged video.
Include start/end bookmarks
Generate a bookmark at the beginning and the end of the selected start and end date/time. The bookmark will use the Title field.
Tagged Video Dialog
The VDG Sense client contains a Tagged Video dialog located in the Live menu. This dialog shows all tagged video of all connected servers. In this dialog, you can comment the tagged video, export the timeframe and release (i.e. untag) the tagged video.
The dialog contains the following information:
Start
Start time of tag
End
End time of tag
Status
Indicates if tag is currently active or inactive. An active status means that the tagging has not yet been stopped.
Server ID
The server ID where the device and storage is located. Will be ‘0’ if all devices are tagged.
Server Name
The name of the server where the device and storage is located. Will be empty if all devices are tagged.
Device ID
The device ID of the tagged video. Will be ‘0’ if all devices are tagged.
Device name
The device name of the tagged video. Will be empty if all devices are tagged.
Title
An optional title to identify the tagged video.
Comment
An optional comment to identify the tagged video.
Export
Export the selected tagged video timerange
Release
Release the tagged video.
Update
Update the tagged video information (used for title and comments)
Average tagged video storage status
The average storage of all tagged video over all servers.
Video tag layout (introduced in 2.7.3)
In VDG Sense 2.7.3, the tagged video dialog was replaced by a fullsize Videotag menu.
It provides an overview of all videotags, including a filter option to easily search for specific videotags
See the screenshot. The selected videotag can be edited, played back directly and exported directly.