Camtrace Web Integration Guide

Introduction

This guide comprises comprehensive information about VEZHA Analytics System web integration with CamTrace VMS. The latest versions of VEZHA plugins already contain a built-in web integration functionality for CamTrace VMS and are ready for use through the Website Widget.

Overview

Before you start, ensure you have correctly installed the latest versions of:

  1. IncoreSoft VEZHA Analytics System (Middleware Core ver. 23.3.46 or higher)
  2. Required IncoreSoft VEZHA analytics and corresponding plugins:
    • Age & Gender Detection (plugin ver. 23.3.12 or higher)
    • Face Recognition (plugin ver. 23.3.25 or higher)
    • Gun Detection (plugin ver. 23.3.12 or higher)
    • Hard Hat Detection (plugin ver. 23.3.11 or higher)
    • LPR (plugin ver. 23.3.33 or higher)
    • Motion Detection (plugin ver. 23.3.9 or higher)
    • Object Detection (plugin ver. 23.3.21 or higher)
    • Pose Estimation (plugin ver. 23.3.12 or higher)
    • Smart Parking (plugin ver. 23.3.16 or higher)
    • Smart Tracking System (plugin ver. 23.3.12 or higher)
    • Smoke & Fire Detection (plugin ver. 23.3.10 or higher)
    • Traffic Analytics (plugin ver. 23.3.18 or higher)
    • UIC & Container (plugin ver. 23.3.15 or higher)
  3. CamTrace Integration plugin for importing video streams from CamTrace VMS to VEZHA Analytics System
  • The latest version of the IncoreSoft VEZHA Analytics System installation file can be found in the Installation Files section of the Partners Portal.
  • Middleware Core version can be checked in the Updates item of the VEZHA system, and updated if necessary.
  • Plugins can be installed and updated in the Plugin Marketplace item of the VEZHA system.

Importing Video Streams

Once the CamTrace Integration plugin is installed, a module for importing video streams from CamTrace VMS becomes available in the system menu. To access it:

  1. Open the Settings section
  2. Select the CamTrace item
  3. See Camtrace settings

To receive video streams from the CamTrace server, select the Connect option. In the Settings Connect Camtrace pop-up window proceed with the following steps:

  1. Fill in the fields to configure the connection to the server:
    • Enter the CamTrace server IP address or domain name in the Host field
    • Enter CamTrace server port, 80 by default
    • Enter CamTrace user's login
    • Enter CamTrace user's password
  2. Click the Save button to connect
  • If you have both VEZHA Middleware Core and CamTrace VMS installed on the same server and intend to use "localhost" in the URL, please ensure that IPv6 is disabled on the server. VEZHA operates exclusively on TCP/IP version 4 (IPv4). To prevent potential compatibility issues or errors, we recommend using an IPv4 address instead of "localhost".
  • Please avoid using the user's password with special symbols such as: "!@#$%^&*()", as it may lead to errors. Symbols "." and "-" are allowed.
  • The user whose credentials are provided for the connection must have access to the video streams on the CamTrace server for further importation.

Once the connection is established, the available video streams will be displayed in the table. To import streams into the VEZHA system:

  1. Check the boxes next to the desired video streams
  2. Choose the desired stream resolution option for the selected video streams:
    • High
    • Medium
    • Low
  3. Click the Import Selected Channels button
Stream resolution options vary based on your camera settings.

All imported CamTrace video streams are accessible in the Video Streams item with the "camtrace" video stream type:

Web Plugin Connection

To connect VEZHA plugins as web integration, log in to your CamTrace VMS Client, navigate to Widgets on the sidebar, and proceed with the following steps:

  1. Right-click the Widgets section
  2. Select the Add Widget option
  3. Choose Website in the context menu

In the Website pop-up window, proceed with the following steps:

  1. Enter the custom plugin name in the Name field
  2. Enter the URL in the following format: "http://your_server_ip_address:port/plugin_name/default_page_name?mode=camtrace&login=your_vezha_login&password=your_vezha_password" in the Address field
  3. Click the Ok button
  • The URL-address example: http://111.22.33.44:2001/alpr/search?mode=camtrace&login=login&password=password
  • The list of available plugin's plugin_name/default_page_name parameters comprises:
    1. Age & Gender Detection: "gender_age/report"
    2. Face Recognition: "face/search"
    3. Gun Detection: "gun_detection/events"
    4. Hard Hat Detection: "hardhat/events"
    5. LPR: "alpr/search"
    6. Motion Detection: "motion/events"
    7. Object Detection: "object_in_zone/events"
    8. Pose Estimation: "fallen_people/events"
    9. Smart Parking: "parking/analytics"
    10. Smart Tracking System: "person_reid/search"
    11. Smoke & Fire Detection: "smoke_fire/events"
    12. Traffic Analytics: "traffic/events"
    13. UIC & Container: "railroad/search"

To edit the plugin connection settings, right-click the required plugin in the Widgets menu and select the Edit option from the context menu.

Web Plugin Utilization

Once the required plugin is connected, it becomes available within the Widgets section. To open the required plugin, double-click it in the menu or hold and drag it to the Scene and patiently wait for the VEZHA authorization process to complete:

Once VEZHA authorization is complete, the desired plugin opens in the Scene and is ready for use.

The web plugin interface resembles the VEZHA Analytics System. All available plugin sections are positioned at the top of the page, as illustrated in the example:

To view the required event playback from the Search section, follow these steps:

  1. Select the desired record
  2. Click its frame preview on the right side of the page
  3. See the event playback in the pop-up window

To view the required event playback from the Events section, follow these steps:

  1. Click the View icon next to the required event
  2. See the event playback in the pop-up window
To view the desired event playback, the video stream must be associated with the required CamTrace camera.

If the required video stream is not associated with the CamTrace camera, the Event Information pop-up window will be opened, as it usually does in the VEZHA Analytics System, as CamTrace VMS cannot get the video archive from non-associated video streams. An example of the Vehicle Information pop-up window is shown in the picture below: