VIVOTEK On‑Premise (NVR) – Prerequisites & Installation Guide  

VIVOTEK On‑Premise (NVR) is a network video recorder that enables secure device management, live video streaming, playback, event handling, and I/O control through C# SDKs.

This document provides an end‑to‑end overview of how VIVOTEK On‑Premise (NVR) devices are onboarded, configured, streamed, and controlled within the platform, and how external applications can integrate with vivotek using SDK and the RTSP Streaming
1. Prerequisites  

Before proceeding, ensure the following requirements are met:

• Valid credentials (username and password) for the VIVOTEK NVR and cameras

• NVR IP address and port accessible from your network

• Cameras powered on and reachable on the same network (for auto‑discovery)

Stable network connectivity
2. Device Onboarding & Configuration  

Log in to the VIVOTEK NVR  

1. Open a browser and log in to the VIVOTEK NVR using its IP address and port.

Authenticate using valid administrator credentials.

Add Cameras  

1. Navigate to Cameras → Management.

2. Click Add / Create.

3. Choose one of the following options:

a. Auto‑Discover (Same Network)

• Click Refresh to discover online cameras available on the same network.

• Select the camera and proceed with authentication.

b. Manual Add

• Enter the camera IP address and port (default: 80).

• Provide the camera username and password.

• Save the configuration.

3. Live Streaming Verification  

1. Navigate to the Live menu.

2. Select the desired camera.

3. Verify that the live video feed is displayed correctly.

4. Playback & Recording Configuration  

Enable Recording  

1. Navigate to System → Recording → Recording Options.

2. Enable recording for the required cameras.

3. Click More Settings if additional configuration is required.

5.Save the configuration and confirm that all required fields are completed.

Playback Verification  

1. Navigate to the Playback menu.

2. Select the preferred camera and date.

3. Verify that:

• The recording time matches the actual event time .The timeline and playback duration are aligned correctly

 5. Events / Alarms (Webhook‑Based Event Integration)  

This integration uses VIVOTEK On‑Premise webhooks, where the NVR actively sends event notifications to an external platform whenever an event occurs.

You must configure a webhook URL in the device web interface that points to your service endpoint.

Using the webhook feature in Alarm Management, you can configure automatic HTTP notifications to be sent whenever a selected rule is triggered. This enables seamless real‑time alert integration with external systems.

5.1 Setting Up Detection Rules (Smart VCA)  

1. Navigate to Cameras → Smart VCA Detection.

2. Click Add.

• Configure the detection area (line or box).

• Select the object type.

• Apply and save the rule.

5.2 Setting Up Webhooks in Alarm Management  

1. Navigate to System → Alarm → Alarm.

• 2. Click Add.

Configure the alarm:

• Alarm Name: Use a clear naming convention, e.g., C1_LD (Camera 1 – Loitering Detection)

• Triggered Duration: Set to 3 seconds

• Camera: Select the target camera

• Event Type:

• Smart VCA → Loitering Detection (for loitering)

• Smart VCA → Intrusion Detection (for intrusion)

• Example naming:

• Loitering Detection: C1_LD

• Intrusion Detection: C1_ID

• Continue to the Action step.

5.3 Configuring HTTP Action (Webhook)  

1. Set Action Type to HTTP.

2. Provide the webhook URL in the following format:

http://vivotekonpremproxy.nxgen.cloud:1880/eventPush?data=genesisDeviceId_<deviceID>,genesisSensorId_<sensorID>,eventType_<EventName>

Example (Intrusion Event):

http://vivotekonpremproxy.nxgen.cloud:1880/eventPush?data=genesisDeviceId_f109c4fc6fad46d5b9d06b26a5cf04e5,genesisSensorId_01beb497195943c1af2f54c5b7bb55b5,eventType_Intrusion

3. Ensure the eventType value matches the event mapping defined in the VIVOTEK–ON PREMISE Event Mapping Sheet.

4. Proceed to the next step.

5.4 Finalizing the Alarm  

1. Select Alarm Schedule and set it to Full Time (or as required).

2. Save the alarm configuration.

Note:

• Each event type requires a separate alarm configuration, even for the same camera.

• Always verify that the Device ID, Sensor ID, and Event Type are correct and match the mapping sheet.

VIVOTEK ON-PREMISE Integration in genesis

•  Add Vivotek On-premise Parameters to Genesis:

• Parameter Type : string

• Parameter Name : VivotekOnPremise_Device_Custom_baseUrl

• Parameter Value : http://vivotekonpremproxy.nxgen.cloud:1880/

• Parameter Type : string

• Parameter Name : VivotekOnPremise_Device_Custom_localNodeUrl

• Parameter Value : http://localhost:1880/

• Parameter Type : string

• Parameter Name : VivotekOnPremise_Device_Custom_localStreamUrl

• Parameter Value : http://localhost:1880/

Steps to add custom property:

• Step 1: Login to genesis

• Step 2: Navigate to configuration app

• Step 3: At service provider level, click on edit button under overview tab

• Step 4: Click on additional settings tab->Custom property

• Step 5: Scroll down and click on the "Add +" button

Step 6: Enter parameter name and value as mentioned above

• Parameter Type : string

• Parameter Name : VivotekOnPremise_Device_Custom_baseUrl

• Parameter Value : http://vivotekonpremproxy.nxgen.cloud:1880/

• Parameter Type : string

• Parameter Name : VivotekOnPremise_Device_Custom_localNodeUrl

• Parameter Value : http://localhost:1880/

• Parameter Type : string

• Parameter Name : VivotekOnPremise_Device_Custom_localStreamUrl

• Parameter Value : http://localhost:1880/

• Add Vivotek On-premise device under the required site:

• Navigate to the Configuration section in Genesis.

• Navigate to Devices → Add New Device:

Fill in the Following Device Details  

Enter the required information to add the VIVOTEK On-Premise device:

• Device Name:
  Example: Device

• Device Type:
  Vivotek On-Premise

• IP Address / Host:
  Example: 192.168.1.100

• User Name:
  Camera administrator username

• Password:
  Camera administrator password

• HTTP Port:
  Example: 80 or the configured HTTP port of the NVR

• RTSP Port:
  Example: 554

• ⚠️ Ensure the RTSP port is correctly configured, as it is required for live streaming and playback to function properly.

• Navigate to Video Viewer :

• Navigate to Video Activity Search.