Skip to main content
Back to Hanwha Vision Tech Support Portal

WAVE: How to set up system-wide settings for the AI Plugin

  • Updated

Applies to: WAVE

Summary:

The WAVE AI Plugin includes system-wide settings that apply to all cameras connected to the server. This article outlines how to configure these settings.

NOTE: Some settings will only take effect the media server is restarted.

Step By Step Guide:

Accessing System Administration

To access the System Administration settings:

  1. From the WAVE Client, click the Hamburger icon in the top left corner and select System Administration (you can also press the Ctrl+Alt+A).

  2. Click the Plugins tab then click the plugin name on the left menu panel.

Configuring the AI Plugin

Operating Mode

The Operating mode settings allow users to optimize the computational load based on specific surveillance use cases.    

IMPORTANT: Changing these settings requires restarting the media server.

  • Standard - the default suggested profile, offering optimal performance while maintaining high precision for common security analytics. This mode uses the secondary camera stream ensuring a balance between system performance and detection accuracy.

  • Hi-res - utilizes a larger AI model and the primary camera stream, enhancing the detection of smaller targets at a distance or in more crowded environments. Enable this mode only if the Standard mode proves insufficient.

Automatic Stream Selection

When enabled, Automatic Stream Selection configures the streams as follows:

  • Standard - uses the secondary stream
  • Hi-res - uses the primary stream

When this feature is disabled, you can override the stream selection for running analytics. Disabling this feature allows you to select either the Primary or Secondary stream for running analytics on each camera. 

To access Camera Stream settings:

  1. Right-click the video stream and select Camera Settings.

  2. ⁠Click the Plugin tab and select WAVE AI on the left menu panel.
NOTE: The Camera Stream selection is available only when the 
Automatic Stream Selection is disabled in the Plugin tab of the 
System Administration settings. 
IMPORTANT: Starting with version 6 of the Media Server, if you plan to 
activate the plugin on an RTSP stream, you must disable the automatic 
stream selection or use the Hi-res profile.

Video Stream Configuration

To set up Video Stream Configuration:

  1. From the WAVE Client, right-click the video stream and select Camera Settings.

  2. ⁠Click the Advanced tab.

  3. Click Video Stream Configuration on the left side menu panel.

Recommended parameters for the Secondary Stream:

  • Resolution: 640x480

  • Bitrate: 1 Mbps or higher

  • FPS (Frames Per Second): 5 FPS or higher
NOTES:
Resolution - A low resolution can hinder the detection of smaller targets.
Bitrate - A low bitrate leads to strong compression, reducing the quality 
of the video feed and making it difficult to detect smaller targets.
FPS - A low frame rate may cause loss of detections, while a high FPS will 
increase the system's computational load.

Overlay Statistics

Overlay Statistics can be useful for debugging, providing insights into system health, and hardware utilization.

IMPORANT: Do NOT keep the statistics panel open. When the panel is visualized, 
it could prevent the Media Server from recording correctly.

To display the Statistics Panel:

  1. Check the box next to Overlay statistics.

  2. Click OK to save the settings, then go to the OBJECTS tab. 

    You may need to wait a few seconds for the panel to appear.

Statistics information includes: 

  • Engine version
  • Plugin version 
  • Solution version
  • NX SDK (Client / Server) Version
  • Plugin run time 
  • Mode
  • Camera input 
  • AI input 
  • Codec
  • Frame rate 
  • Input queue 
  • Dropped frames 
  • Instance run time 
  • # frames processed
  • Active licenses

Enable Expert Mode

Enable expert mode includes additional features for fine tuning the plugin performance.



To set up Enable expert mode: 

  1. From the WAVE Client, navigate to System Administration > Plugins > WAVE AI. 

  2. Check the box next to Enable expert mode.

  3. Navigate to Expert mode within plugin settings.

To navigate to Expert mode:

  1. Verify the box next to Ensure expert mode in System Administration settings is checked.

  2. Right-click the video stream and select Camera Settings.

  3. ⁠Click the Plugin tab then select WAVE AI on the left menu panel.

  4. Click Expert mode on the left side menu panel.

  • Max AI resolution allows you to adjust the maximum resolution processed by the AI. By default, the maximum resolution is defined by the Operating mode; however, you can modify this to suit specific needs.

    If you set a value higher than the camera's resolution, the plugin will automatically revert to the camera’s native resolution.

    Increasing the maximum resolution can enhance detection of very small targets.
    IMPORTANT: Only increase the resolution if required, as it may negatively 
    impact system performance.
  • Increasing Detection sensitivity improves the ability to detect challenging targets (e.g., smaller, occluded, or affected by lens noise) but may lead to more False Positives. If the system misses events involving small objects or in busy scenes, change Detection sensitivity to High 

  • Movement sensitivity controls how the system detects motion. Environmental factors such as rain, snow, camera noise, and light reflections can cause false motion detection. Lowering motion sensitivity can minimize these false detections, but it increases the risk of missing fast-moving objects or objects visible for a very short time.

 

 

Related articles