> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/spanish/function-blocks/blocks-reference/input-output/image-inputs/hikvision-camera.md).

# HikVision Camera

Este bloque de función se conecta a cámaras HikVision en tu red y proporciona fotogramas en vivo para procesamiento y visualización posteriores.

## 📥 Entradas <a href="#inputs" id="inputs"></a>

Este bloque de función no requiere ninguna entrada.

## 📤 Salidas <a href="#outputs" id="outputs"></a>

`Image`\
El fotograma en vivo obtenido de la cámara HikVision configurada.

## 🕹️ Controles <a href="#controls" id="controls"></a>

`IP Address`\
Introduce la dirección IP (o nombre de host) de la cámara HikVision a la que deseas conectarte.

Nota: el bloque intentará conectarse a la dirección proporcionada y entregará fotogramas automáticamente mientras se esté ejecutando.

## 🎯 Características <a href="#features" id="features"></a>

* Conexión directa a cámaras HikVision para adquisición de fotogramas en vivo.
* Comportamiento de reconexión automático cuando la dirección de la cámara cambia o se pierde la conexión.
* Soporte básico de parámetros de cámara cuando la cámara/SDK proporciona ajustes (controles de `exposure` y relacionados disponibles vía la configuración de la cámara).
* Mensajes de error claros para ayudar a diagnosticar problemas de conexión.

## 📝 Cómo usar <a href="#usage" id="usage"></a>

1. Introduce la dirección de red de la cámara en el control `IP Address`.
2. Ejecuta el escenario; el bloque se conectará a la cámara y empezará a emitir fotogramas por el socket `Image`.
3. Usa los fotogramas de salida con bloques de visualización, grabación o análisis (ejemplos abajo).

## 📊 Comportamiento durante la ejecución <a href="#evaluation" id="evaluation"></a>

Mientras esté activo, el bloque se conecta a la dirección de cámara indicada y emite de forma continua el último fotograma disponible. Si no se puede establecer la conexión o ésta se pierde, el bloque informará un error y volverá a intentar cuando la dirección se corrija o la cámara vuelva a estar disponible.

## 💡 Consejos y trucos <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Usa `Show Image` para previsualizar fotogramas en la UI mientras construyes tu escenario.
* Guarda fotogramas importantes usando `Image Logger` o `Record Video` para revisión offline.
* Si tus análisis son intensivos, añade `Image Resize` antes de los bloques de modelo para reducir la carga de procesamiento.
* Recorta regiones de interés con `Image ROI` o `Image ROI Select` para centrar el análisis en áreas relevantes.
* Para flujos de conteo o seguimiento, combina con `Object Detection` o `Object Detection - Custom` y después `Object_Detection_Tracker`.
* Usa `Mask Detection` o `Background Subtractor` cuando necesites filtrar personas u objetos en primer plano antes de análisis adicionales.
* Combínalo con `Image Write` o `Multi Image Write` para exportar fotogramas específicos en eventos disparadores.

## 🛠️ Solución de problemas <a href="#troubleshooting" id="troubleshooting"></a>

* Conexión fallida: verifica que la IP de la cámara sea accesible desde la máquina que ejecuta el Studio (haz ping a la cámara, revisa ajustes de red/VLAN).
* No hay fotogramas o aparecen en negro: comprueba alimentación de la cámara, ajustes de exposición/stream en la cámara y que ninguna otra aplicación esté usando la cámara en modo exclusivo.
* Requisito de SDK/controlador: algunos modelos HikVision pueden requerir la instalación del SDK o drivers del proveedor en el sistema; asegúrate de que los paquetes necesarios estén presentes.
* Autenticación o firewall: confirma que las credenciales de la cámara y las reglas de red permitan el acceso desde tu PC o servidor.

Si los problemas persisten, previsualiza la dirección con `Show Image` o revisa de nuevo la red y la configuración de la cámara antes de continuar.