Applies to: All Wisenet Wave

Summary:

Wisenet WAVE doesn't have a direct API method to start or stop manual recording on certain cameras.

This article will provide steps to create a "Generic Event" that can trigger a pre-configured action

recording on the camera(s) you seek to record.

Note: Three entries will be needed in the rules engine:
A Generic Event
A Soft Trigger for Stop
A Soft Trigger for Start

Step By Step Guide:

Creating the Generic Event:

1. Enable recording on the camera(s) in question. This is in the Camera Settings screen. On the "Recording" tab.

NOTE: You can leave the schedule grid to "Do Not Record." But 
recording does need to be enabled on the Camera(s) in question.

2. Right-click on any camera in the camera list on the left.

3. Select "Camera Rules" from the menu.

4. Click the button in the upper right of the Rules Engine.

5. Under the "When" drop-down on the left. Select "Generic Event." As seen in Figure 1

Figure 1:

Note: The Source, Caption, and Description fields directly correlate to 
the URL later in the article. So the longer the names the bigger the URL.
Try to keep them short and simple, yet logical descriptions.
These fields are also case sensitive. If it's upper case in these fields.
It will need to be upper case in the URL.

6. On the right-hand side of Figure 1. You have the "Do" dropdown. Select "Camera Recording."

7. Under the "Do" drop-down you have the "At" selector. When you click on this you will get a camera selection screen. Select the camera(s) in question.

8. Quality and FPS are your decision to make.

9. You can set "Pre-Recording to 1 second, or longer. And "Post-Recording" to Zero, or longer.

10. Click the "Apply" button at the bottom right of the screen.

NOTE: You may have to click OK. Exit the Rules screen and go back in.

Creating Soft Triggers:

Figure 2:

1. Click the button again in the rules engine again.

2. On the "When" drop down in Figure 2. Select "Soft Trigger"

3. The "At" drop-down will be where you Select your camera(s) again. This is for adding the selected button icon to that actual camera view.

4. The "Available to" selector is if you want to restrict this option to only certain users or groups.

5. Give the function a name. Like "Start recording."

6 The "Icon" selector is for choosing an actual icon for this function. 

7. On the right-hand side of Figure 2 you will see the "Do"  dropdown again. Select "Do HTTP request."

8. The "Interval" check box should be checked, and an interval of at least one minute should be present. This will prevent users from flooding the server with HTTP requests.

http://<server_ip>:<server_port>/api/createEvents?state=<status>&source=<source_text>&caption=<caption_text>&description=<description_text>

8. You can copy the URL above. Remember anything in "<>" brackets is a field you have to change. And you remove the brackets as well as the text between them.

• <Server_ip> = Your Wave Servers IP
• <Server_Port> = The HTTP port your Wave Server uses.
• <Status> = This is the status of this command Active turns this on. Inactive. Turns it off.

NOTE: Changing the status from "Active" to "Inactive" Is the only thing
that needs to be change on the "Stop Recording" Soft Trigger.

• <Source_Text>, <Caption_Text>, and <Description_Text> fields DIRECTLY relate to the fields you set up in the "Generic Event" earlier in this article.

9. The "Content Type" drop-down need to be set to "Auto"

10. Enter the "admin" account credentials into the "Login" and "Password" fields.

11. "Authentication Type" set to "Auto"

12. "Request Type" set to "Get"

13. Click "Apply" And you have set up a soft trigger.

NOTE: Repeat the entire "Creating Soft Triggers" section to create the
"Stop Recording" button. The only thing you do different is changing the 
<Status> section of the URL to "Inactive." And change the "Icon" for the
button. Remember that the <Status> field is also case sensitive.