---
title: "Hanwha-Techwin"
source: /es/gcxone/devices/hanwha-techwin
locale: es
updated: 2026-09-29
---
## Introducción

GCXONE se integra con las cámaras Hanwha Vision mediante SUNAPI para el descubrimiento de dispositivos y la integración de eventos/dispositivos. Una vez añadido el dispositivo, la transmisión de la cámara es utilizada por el GCXONE **Visor de video** para el monitoreo en vivo. Los eventos generados por el dispositivo Hanwha son recibidos por GCXONE y mostrados en **Búsqueda de video**.

## Requisitos previos

- La cámara Hanwha Vision está encendida y es accesible desde el entorno GCXONE.
- Se conoce la dirección IP de la cámara y es estable/reservada.
- Están disponibles credenciales válidas de administrador de la cámara.
- El tráfico necesario de descubrimiento/integración HTTP/HTTPS, RTSP y SUNAPI está permitido por la red/firewall.
- El firmware de la cámara admite las funciones SUNAPI requeridas por la integración GCXONE.
- La hora/fecha de la cámara es correcta y está sincronizada cuando sea posible; las marcas de tiempo correctas son importantes para la búsqueda y correlación de eventos.
- Para eventos de movimiento/analítica, la cámara está instalada de modo que el área deseada de movimiento de personas/objetos sea visible.

## Configuración de Hanwha-Techwin

La configuración de eventos se realiza en la cámara Hanwha Vision. Los nombres exactos del menú varían según el modelo y el firmware de la cámara. Algunos modelos P Series y X-Core/Plus utilizan **Configuración de regla de evento**, mientras que otros modelos aún pueden usar **Configuración de evento**.

### Permitir la Fuente de Evento/Analítica

**Paso 1:** Inicie sesión en la cámara Hanwha Vision mediante su interfaz web.

**Paso 2:** Abra **Configuración**.

**Paso 3:** Vaya a **Evento** / **Analítica** según el modelo de cámara (por ejemplo, **Evento** \> **Configuración de evento**), y seleccione el canal (por ejemplo, **CH 1**).

**Paso 4:** Para eventos de movimiento, permitir **Detección de movimiento** y configure el área de detección requerida.

**Paso 5:** Para eventos AI/IVA, permitir el analítico requerido y configurar la línea/área/objeto virtual según lo admita la cámara.

**Paso 6:** Aplique/guarde la configuración.

El flujo de trabajo de detección de movimiento es: permitir detección de movimiento, seleccionar un área de detección, dibujar el área requerida en la vista de la cámara y aplicar la configuración.

### Configurar la Regla de Evento

Para cámaras que tienen **Configuración de regla de evento**, cree una regla de evento que tenga el disparador y la acción de evento requeridos. Una regla de validación típica es una regla de Detección de movimiento activada para el horario requerido.

**Paso 1:** Navegue a **Setup** \> **Event** \> **Configuración de regla de evento**.

**Paso 2:** Seleccione **Add** para crear una regla.

**Paso 3:** Introduzca un **Nombre de la Regla**, por ejemplo `NXGEN_Motion_Test`.

**Paso 4:** Seleccione el canal.

**Paso 5:** Bajo **Disparador de evento**, seleccione **Detección de movimiento**, **IVA**, Detección de objetos, Línea virtual, Área virtual, o el disparador de evento requerido compatible con la cámara.

**Paso 6:** Permita la regla y seleccione la **Programación**.

**Paso 7:** En **Acción de evento**, configure la acción de evento requerida por el flujo de trabajo del dispositivo/grabación.

**Paso 8:** Guarde/aplique la regla.

**Paso 9:** Genere un evento de prueba real frente a la cámara.

![Diálogo de configuración de regla de evento de Hanwha Vision que muestra la lista de disparadores de Evento y la opción Añadir acción bajo Acción de evento](/api/media/file/02-event-rule-trigger-list-edited-f11e63bf.png?prefix=media)

![Diálogo de configuración de regla de evento de Hanwha Vision con detección de Movimiento seleccionada para el canal 1 y una acción Grabar/Ir a preset para los canales 1 a 4](/api/media/file/03-event-rule-motion-action-edited-a7634894.png?prefix=media)

![Lista de configuración de regla de evento de Hanwha Vision con la regla de Movimiento establecida en Activado](/api/media/file/04-event-rule-list-edited-e4ff83ee.png?prefix=media)

Esta es una ilustración de referencia; los campos de la UI de Hanwha varían según el modelo y el firmware.

La **configuración de regla de evento**La página muestra la regla de movimiento habilitada con sus columnas de disparador de evento y acción de evento.

### Hacer Eventos Disponibles en la Búsqueda de Hanwha

Se recomienda la siguiente secuencia cuando los eventos de cámara deben ser visibles en Hanwha Vision.**Buscar** interfaz.

**Paso 1:** Permita la fuente analítica/evento: permita la detección de Movimiento, IVA, detección de objetos, línea/área virtual, o la analítica requerida en la cámara.

**Paso 2:** Defina el área de detección: dibuje la zona de detección sobre el área real de movimiento de personas/objetos. Evite apuntar la cámara a una pared vacía o fondo irrelevante.

**Paso 3:** Cree/permisar la regla de evento: bajo **configuración de regla de evento**, permita el disparador correspondiente y guarde la regla.

**Paso 4:** Configure la programación de grabación/evento: donde el modelo lo requiera para la grabación/búsqueda de eventos, configure la programación de grabación para incluir **Evento** o **Evento/Continuo**.

**Paso 5:** Genere un evento de prueba: camine/muévase a través de la zona de detección configurada y espere a que la cámara registre el evento.

**Paso 6:**Confirme el evento en la cámara: utilice los indicadores Live/Event de la cámara o los registros, cuando estén disponibles, para verificar que el evento se haya generado.

**Paso 7:**Verificar búsqueda: abra Hanwha Vision.**Search** interfaz, seleccione el canal/rango de tiempo/filtro de evento apropiado y confirme que se devuelva el evento generado.

![Página de búsqueda de Hanwha Vision con CAM 01 seleccionado bajo dispositivo de destino, una fecha seleccionada y el evento marcado en la línea de tiempo.](/api/media/file/05-hanwha-search-edited-e41d6633.png?prefix=media)

**Paso 8:**Validar en GCXONE: después de que se genere el mismo evento, confirme que el evento correspondiente se reciba y muestre en **Búsqueda de video**(ver Validar eventos en GCXONE).

La secuencia completa es: activar la detección de movimiento requerida, definir el área de detección, configurar el comportamiento de grabación/evento y, a continuación, activar la regla Motion en **Configuración de regla de evento**.

![Página de configuración de eventos de Hanwha Vision con CH 1 seleccionado, la pestaña Motion abierta, detección de movimiento activada y un área de detección dibujada](/api/media/file/01-event-setup-motion-edited-fbdfc2de.png?prefix=media)

## Guía de configuración Hanwha-Techwin con GCXONE

### Añadir Dispositivo

**Paso 1:** En GCXONE, vaya a **Configuración** y abra el cliente y el sitio donde se añadirá la cámara.

**Paso 2:** Abra la **Dispositivos** pestaña y haga clic en **Agregar nuevo**. La **Añadir Dispositivo** cuadro de diálogo se abre.

**Paso 3:** En la **Device** lista desplegable, seleccione **Hanwha-Techwin**.

**Paso 4:** Introduzca un **Nombre** para el dispositivo y, si es necesario, seleccione un grupo de entidad en **Seleccionar grupo de entidades**.

**Paso 5:** En **Ajuste de conexión**, introduzca el **Dirección IP o Nombre de host**, **Número de serie**, **Nombre de usuario**, **Contraseña**, **Puerto de control**, **Puerto RTSP**, **Puerto del servidor**y**Port HTTPS**. Los valores de puerto deben coincidir con la configuración de la cámara.

**Paso 6:** Seleccione el **Zona horaria** (obligatorio). Ajuste **Habilitar audio**, **Configuración del Dispositivo**, **Configuración avanzada**y**Ubicación** si es necesario, y confirme que los campos obligatorios están completados.

**Paso 7:** Seleccione **Descubrir**. GCXONE valida el dispositivo y recupera la información de dispositivos/canales compatibles.

**Paso 8:** Después de un descubrimiento exitoso, haga clic en **Guardar** para guardar el dispositivo.

**Paso 9:**Confirme que el dispositivo está listado bajo el sitio del cliente en el **Dispositivos** pestaña.

### Validar el Stream en Directo

Después de guardar el dispositivo, la cámara está disponible en el árbol de dispositivos GCXONE.

**Paso 1:** Abra el **Visor de video**.

**Paso 2:** En **Explorador de Dispositivos**, en la **Dispositivos** pestaña, localice el dispositivo Hanwha Vision recién añadido.

**Paso 3:** Arrastre y suelte el dispositivo/canal sobre la cuadrícula de visualización de video, o haga doble clic en él en el árbol de dispositivos.

**Paso 4:** Espere a que el Stream en Directo se inicialice.

**Paso 5:** Verifique que el video En Vivo sea visible y que el stream permanezca estable durante varios minutos.

### Validar Eventos en GCXONE

Una vez que la cámara está configurada y genera eventos, valide la ruta completa del evento.

**Paso 1:** Active el evento configurado en la cámara.

**Paso 2:** Confirme que el evento es generado por el dispositivo Hanwha.

**Paso 3:** Confirme que GCXONE recibe el evento a través de la integración Hanwha-Techwin (SUNAPI).

**Paso 4:** Confirme que el evento está asignado al dispositivo/canal correcto en GCXONE.

**Paso 5:** Abra **Búsqueda de video** y verifique que el evento aparezca.

**Paso 6:** Compare la marca de tiempo del evento con la marca de tiempo de la cámara y la marca de tiempo de la Búsqueda de video.

**Paso 7:**Repita con al menos dos o tres eventos para verificar la consistencia en lugar de un solo disparo exitoso.

## Resolución de problemas

| Síntoma | Verificaciones probables | Acción |
| --- | --- | --- |
| Falla al descubrir | Alcanzabilidad IP; credenciales; tráfico de descubrimiento SUNAPI; puerto HTTP/HTTPS | Verifique la ruta de red y el inicio de sesión web de la cámara; verifique los puertos configurados y las reglas de firewall. |
| El Dispositivo guarda pero la transmisión está en blanco | Puerto RTSP; perfil de transmisión; códec; credenciales; red | Valide la alcanzabilidad del puerto RTSP y la configuración de la transmisión de la cámara; pruebe un perfil H.264 compatible si el reproductor tiene limitaciones de códec. |
| La transmisión funciona pero no hay eventos en Búsqueda de vídeo | Fuente de Eventos desactivada o asignación de canal/evento incorrecta | Verifique primero la generación de eventos de la cámara; luego valide la recepción/asignación de eventos de GCXONE. |
| El evento no está en la Búsqueda de Hanwha | Regla de Eventos; zona de detección; programación; configuración de Grabación | Verifique que el evento se genere realmente; verifique que se haya seleccionado el canal/rango de tiempo correcto; verifique que la configuración de Eventos/Grabación esté activada donde sea necesario. |
| Los Eventos tienen marcas de tiempo incorrectas | Desfase de tiempo entre la cámara y GCXONE | Sincronice la hora de la cámara y del servidor/NTP y repita la prueba. |
| Eventos falsos frecuentes | Zona de detección/sensibilidad demasiado amplia | Reduzca el área de detección; ajuste la sensibilidad/duración mínima; vuelva a probar. |

### Notas de red y protocolo

Hanwha Vision enumera SUNAPI Discovery como UDP 7701 y documenta la comunicación web HTTP/HTTPS. Los puertos exactos pueden variar según el rol/modelo y la configuración del Dispositivo, por lo que los valores mostrados en GCXONE deben coincidir con la configuración de la cámara en lugar de depender de un valor predeterminado universal.

**Importante:** El puerto RTSP debe ser el valor configurado/soportado por la cámara específica. No asuma el puerto de un dispositivo o modelo de grabador Hanwha diferente.