*startVideoTag

Configuration Article | CA-20220907-TP-73

VDG Sense | API | Functions | Video Tagging

1 Start tagging video
- 1.1 Notes:
2 Changelog

Note: This function requires an API license.

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.

The actions server.tagVideoStart and server.tagVideoStop respectively starts and stop tagging video. Once the video is tagged it will not be deleted. The user should use the system to untag the video’s manually. Untagged video will then be deleted normally. These actions can be send to the system with the executeAction command

Start tagging video

Starts tagging video so recordings will not be deleted. Without optional parameters serverid and deviceid, all servers will tag their recorded video (and accompanying metadata). An extra parameter pretime can be added, this value will move the start time of the videotag backwards in time, with a maximum of 24 hours. The pretime value needs to be defined in seconds.
Tagged data will not be deleted by the system. The user is responsible to untag the data on systems.

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.

Command url:

http://<server>/command?command=executeAction

Post data:

<!--?xml version="1.0"?-->
 <action>
  <name>server.tagVideoStart</name>
<parameters>
   <parameter name="serverid">[serverid]</parameter>
   <parameter name="deviceid">[deviceid]</parameter>
   <parameter name="pretime">[pretime - seconds]</parameter>
   <parameter name="posttime">[posttime - seconds]</parameter>
   <parameter name="title">[summary of tag]</parameter>
   <parameter name="comment">[videotag comments]</parameter>
</parameters>
</action>

or

http://<server>/command?command=executeaction&actionname=server.tagVideoStart&serverid=[serverid]&deviceid=[devideid]&pretime=[pretime]60&title=[title]&comment=[comment]

Notes:

If parameters serverid and deviceid are not added, the video of all cameras will be tagged
Pre- and posttime parameters are optional. If a posttime is added, the videotag will automatically receive the status ‘Inactive’.

Result:

Changelog

Sense version 2.7.3: added parameter ‘posttime’