Hanwha Wisenet Integration Guide

Hanwha Wisenet cameras provide a full-featured web interface for configuration.

1. Open a browser and navigate to http://[camera-ip]
2. Log in with admin credentials. If this is first access, you will be prompted to set a password that meets complexity requirements (minimum 8 characters, mixed case, numbers, special characters)
3. Accept the HTTPS certificate warning if connecting over HTTPS (the camera uses a self-signed certificate by default)
4. The dashboard displays a live preview and quick-access links to configuration sections

Note: Wisenet cameras require Internet Explorer with the ActiveX plugin for live view in the web UI. For configuration only, any modern browser works. AgenticEye does not require the web UI plugin — it connects directly via RTSP/ONVIF.

RTSP is enabled by default on most Wisenet cameras. Verify and configure the streaming profiles.

1. Navigate to Setup → Network → RTSP
2. Confirm RTSP is enabled and port is 554
3. Under Authentication, set to Digest (recommended) or Basic
4. Navigate to Setup → Video & Audio → Video Profile
5. Configure profiles:
   • Profile 1 (main stream): H.264, full resolution, 15-20 FPS, 4096-6144 Kbps CBR
   • Profile 2 (sub stream): H.264, 1280x720, 10 FPS, 1024-2048 Kbps CBR

# Wisenet RTSP URL format — profile number maps to [N]:
rtsp://[username]:[password]@[ip]:554/profile1/media.smp  # Main stream
rtsp://[username]:[password]@[ip]:554/profile2/media.smp  # Sub stream
rtsp://[username]:[password]@[ip]:554/profile3/media.smp  # Profile 3 (if configured)

ONVIF provides standardized camera discovery, PTZ control, and event subscription capabilities.

1. Navigate to Setup → Network → ONVIF
2. Set ONVIF to Enable
3. The default ONVIF port on Wisenet cameras is 80 (shared with the web interface)
4. Under ONVIF User, add a user or verify that your existing user is listed. Wisenet cameras maintain a separate ONVIF user list — camera users are not automatically available for ONVIF
5. Set the ONVIF user privilege to Operator or Administrator
6. Enable WS-Discovery if you want AgenticEye to auto-discover the camera on the network

# ONVIF device service URL:
http://[ip]:80/onvif/device_service

# Test ONVIF with python-onvif:
from onvif import ONVIFCamera
cam = ONVIFCamera('[ip]', 80, 'admin', 'YourPassword')
media = cam.create_media_service()
profiles = media.GetProfiles()
for p in profiles:
    print(f"Profile: {p.Name}, Token: {p.token}")

Sunapi is Hanwha's proprietary HTTP-based CGI interface. It provides granular control over camera settings and can serve as an alternative or supplement to RTSP/ONVIF.

1. Sunapi is available by default on all Wisenet cameras — no additional configuration is needed
2. It uses the same HTTP port (80 or 443) and credentials as the web interface
3. AgenticEye can use Sunapi for snapshot capture, stream retrieval, and advanced event configuration

# Sunapi — view live stream (MJPEG):
http://[ip]/stw-cgi/video.cgi?msubmenu=stream&action=view&Profile=1

# Sunapi — capture a JPEG snapshot:
http://[ip]/stw-cgi/image.cgi?msubmenu=snapshot&action=view&Profile=1

# Sunapi — get device information:
http://[ip]/stw-cgi/system.cgi?msubmenu=deviceinfo&action=view

# Sunapi — list video profiles:
http://[ip]/stw-cgi/video.cgi?msubmenu=profile&action=view

# Authentication: Sunapi uses HTTP Digest auth by default
# Test with curl:
curl --digest -u admin:YourPassword \
  "http://192.168.1.100/stw-cgi/system.cgi?msubmenu=deviceinfo&action=view"

With your streams configured, connect the camera to AgenticEye.

1. Log in to your AgenticEye dashboard at app.agenticeye.com
2. Navigate to Cameras → Add Camera
3. Select Hanwha / Wisenet from the manufacturer dropdown
4. Choose your integration method:
   • RTSP — direct stream URL (recommended for most setups)
   • ONVIF — auto-discovery with PTZ and event support
   • Sunapi — proprietary API for advanced integrations
5. Enter the connection details and credentials
6. Name the camera with a descriptive label
7. Click Test Connection, then Save & Activate