*Examples – Video tagging

Configuration Article | CA-20220907-TP-85

VDG Sense | API | References

1 Start tagging video
2 Stop tagging video

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">8712348723918719871</parameter>
   <parameter name="deviceid">3</parameter>
   <parameter name="pretime">60</parameter>
</parameters>
</action>

or

http://<server>/command?command=executeaction&actionname=server.tagVideoStart&serverid=8712348723918719871&deviceid=3&pretime=60

(if parameters serverid and deviceid are not added, the video of all cameras will be tagged)

Result:

Stop tagging video

Stops tagging video. The untagged video and metadata will be normally deleted (oldest images first during the cyclical deleting scheme). The previously tagged data will remain tagged and will not be deleted by the system. The user is responsible to untag the data on the system.