HikVision Camera

This function block connects to HikVision cameras on your network and provides live image frames for downstream processing and visualization.

📥 Inputs

This function block does not require any inputs.

📤 Outputs

Image The live frame retrieved from the configured HikVision camera.

🕹️ Controls

IP Address Enter the camera IP address (or host name) of the HikVision device you want to connect to.

Note: the block will attempt to connect to the provided address and provide frames automatically while running.

🎯 Features

• Direct connection to HikVision cameras for live frame acquisition.

• automatic reconnect behavior when the camera address changes or connection is lost.

• Basic camera parameter support when the camera/SDK provides settings (exposure and related controls available via camera settings).

• Clear error messages to help diagnose connection problems.

📝 How to use

1. Enter the camera network address into the IP Address control.

2. Run the scenario; the block will connect to the camera and start outputting frames through the Image socket.

3. Use the output frames with visualization, recording, or analysis blocks (examples below).

📊 Running behavior

When active, the block connects to the given camera address and continuously outputs the latest available frame. If the connection cannot be established or is lost, the block will report an error and will retry when the address is corrected or the camera becomes available again.

💡 Tips and Tricks

• Use Show Image to preview frames in the UI while building your scenario.

• Save important frames using Image Logger or Record Video for offline review.

• If your analytics are heavy, add Image Resize before model blocks to reduce processing load.

• Crop regions of interest with Image ROI or Image ROI Select to focus analysis on relevant areas.

• For counting or tracking workflows, pair with Object Detection or Object Detection - Custom and then Object_Detection_Tracker.

• Use Mask Detection or Background Subtractor when you need to filter persons or foreground objects before further analysis.

• Combine with Image Write or Multi Image Write to export specific frames on trigger events.

🛠️ Troubleshooting

• Connection fails: verify the camera IP is reachable from the machine running the studio (ping the camera, check network/VLAN settings).

• No frames or black frames: check camera power, exposure/stream settings on the camera, and ensure no other application is exclusively using the camera.

• SDK/driver requirement: some HikVision models may require vendor SDK or drivers to be installed on the system—ensure required camera support packages are present.

• Authentication or firewall blocks: confirm camera credentials/network rules allow access from your PC or server.

If problems persist, preview the address with Show Image or re-check network and camera settings before continuing.