The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter provides information about the Video Tag app for Cisco Video Surveillance 8000 Series IP cameras. This app applies a tag to a live video image based on an external trigger. The tag appears as text on the video image from the IP camera. The app also can cause the IP camera to take a designated action.
The Video Tag app causes a tag to appear on the live video image from the IP camera when the app detects a designated external trigger.
A tag is preconfigured text, for example “Door open” or “Entry alarm activated.” You can configure the Video Tag app to respond to either or both of the following external trigger types:
If you used the Video Overlay window in the IP Camera web-based user interface to configure overlay text, statistics, or an image, the tag from the Video Tag app replaces the configured overlay item or items. The configured overlay item or items redisplay when the tag is cleared.
Before you can use the Video Tag app, you must configure it on each IP camera on which it will run. To configure this app, perform the following steps.
Step 1 From the IP camera web-based user interface, click Configuration in the menu bar, and then choose Applications > Package Management from the left panel.
Step 2 Click the VideoTag radio button, then click VideoTag in the Module Name column in the Package list table.
The Cisco Video Tag Application page appears.
Step 3 Enter appropriate values in the Cisco Video Tag Application page fields as described in the following table:
Step 4 Click the Save button in the Cisco Video Tag Application configuration page, and then click OK in the confirmation dialog box.
If you want to reset the options in the Cisco Video Tag configuration page to their default values, click the Reset button, click OK in the two dialog boxes that appear, click the Save button, and then click OK in the confirmation dialog box.
If you change configuration values while the Video Tag app is running, you must stop and then restart the app before the changes take effect.
If you want the Video Tag app to display a tag when it detects an HTTP POST request, you must configure the HTTP trigger options as described in the “Configuring the Video Tag App on an IP Camera” section. In addition, you must ensure that the request is sent in the format that this section describes.
An HTTP POST request can be generated from a third-party application or add-on, such as the Advanced REST Client Application for Google Chrome, the RESTClient add-on for Mozilla Firefox, or the Linux wget command. The app can receive the request from any external source that can send HTTP requests and that is on the same network as the IP camera on which the app is running.
The HTTP POST request should include the elements that Table 5-1 describes.
The following examples show two ways in which you can generate an HTTP POST trigger for the video tag app. In each example:
Example 5-1 Sending an HTTP POST Request by Using the REST Client Application for Google Chrome
Figure 5-1 shows an example of using the REST Client Application for Google Chrome to generate an HTTP POST trigger for the Video Tag app. The REST Client Application application receives the status message “200:OK” when the request is successfully sent.
Figure 5-1 HTTP POST Request Using the REST Client Application for Google Chrome
Example 5-2 Sending an HTTP POST Request by Using the Linux wget Command
The following example shows using the Linux wget command to generate data in the form of an HTTP POST request and send the request to the Video Tag app:
$ wget --header="Content-Type: text/xml" --post-data="<HttpTrigger><EnableTrigger>1
</EnableTrigger><TriggerDescription>Door Open</TriggerDescription></HttpTrigger>" 'http://10.110.0.00:48999'
To run the Video Tag app on an IP camera, use the start and stop functions for apps in Cisco VSM. Do not use the Run and Stop buttons that appear in the IP Camera web-based user interface.