Guía de Integración de la Familia Axis Communications

Introducción

Esta guía describe la integración de extremo a extremo entre la Plataforma de Monitoreo NXGEN y la familia de dispositivos Axis Communications, incluidos Axis Network Cameras (Cámaras IP), Axis Network Audio Systems (Altavoces de bocina), Axis I/O Relay Modules y Axis Camera Station Pro (ACS). El objetivo de esta integración es permitir un monitoreo unificado, ingestión de eventos, control de dispositivos, acciones de audio y una configuración simplificada de los dispositivos Axis desde el ecosistema NXGEN.

Visión General del Sistema

Los dispositivos Axis se comunican mediante una combinación de protocolos estándar de la industria y protocolos nativos de Axis:

NXGEN consume los datos de Axis para:

• Transmisión de video En Vivo
• Notificaciones de eventos/alarmas
• Cambios de estado de I/O
• Anuncios de audio
• Reproducción de video almacenado en ACS

Arquitectura del Sistema

Las cámaras Axis, dispositivos de audio, ACS Pro y módulos I/O se conectan localmente al router del sitio, que enlaza de forma segura con la nube mediante VPN (preferido) o sin VPN. NXGEN recibe todas las transmisiones de video, alarmas y telemetría de dispositivos desde el punto final en la nube y las presenta a los operadores de monitoreo a través de diversas aplicaciones. La arquitectura permite:

1. Gestión centralizada
2. Manejo unificado de eventos
3. Controles de audio e I/O en tiempo real
4. Monitoreo escalable de múltiples sitios

Flujos de Comunicación

Configuración de la familia Axis Communications

Requisitos previos a la integración

Paso 1: Dispositivo Axis actualizado al último firmware.

Paso 2: HTTP activado.

Paso 3: Usuario de acceso API con los privilegios necesarios.

Paso 4: Para ACS Pro:

• "Web Client" activado
• Los puertos 29202 (TCP), 29204 (API) y 29205 (streaming) están abiertos (según la versión), 80 y 443.

Paso 5: Asegúrese de la conectividad de red (ya sea acceso a red pública o a través de VPN) entre la red del Site y la plataforma de monitoreo (GCXONE).

Paso 6: Para cámaras IP:

• Habilitar API VAPIX (habilitado por defecto).
• El puerto API está abierto y accesible.
• Habilitar servicio de eventos.
• Configure los parámetros RTSP si es necesario (códec, bitrate) para que coincidan con el ancho de banda de su red.

Guía de configuración de la familia Axis Communications con GCXONE

A continuación encontrará los pasos para agregar Axis Camera Station (ACS) Pro, módulos Axis I/O y altavoces de bocina de red Axis al entorno GCXONE.

Configuración de dispositivos de la familia Axis

Paso 1: Inicie sesión en la plataforma GCXONE

1. Abra la URL (GCXONE Cloud Experience) en un navegador.
2. Inicie sesión con sus credenciales de administrador o integrador.
3. Tras iniciar sesión correctamente, el sistema inicializa su sesión y carga el entorno asociado a su inquilino.

Paso 2: Seleccione su organización

Si su inquilino está configurado con varias organizaciones, GCXONE le pedirá que seleccione la organización que desea gestionar.

1. Si existen varias organizaciones: verá una pantalla de selección de organización. Elija la organización correcta para continuar.
2. Si solo existe una organización: GCXONE lo inicia automáticamente en la organización predeterminada y carga directamente el panel.

Paso 3: Navegue a la Aplicación Configuración

1. En el panel de Aplicaciones del lado izquierdo, localice el ícono de Configuración.
2. Haga clic Configuración para abrir el espacio de trabajo de configuración.
3. El sistema cargará la pantalla de configuración unificada, donde se gestionan todos los perfiles de cliente, ubicaciones y dispositivos.

Paso 4: Comprensión de la jerarquía de Configuración

GCXONE sigue una jerarquía estricta e intuitiva para garantizar una clara propiedad de los dispositivos y mantener una estructura de datos limpia: Cliente → Ubicación → Dispositivo → Cámaras/Sensores.

Cómo funciona esta jerarquía

• Cliente:Representa la entidad organizativa de nivel superior (p. ej., una empresa, corporación o cliente). Cada cliente contiene una o más ubicaciones físicas o lógicas.
• Ubicación:Representa una ubicación física o área de despliegue (oficina, almacén, sitio de torre, tienda minorista, etc.). Los dispositivos desplegados en la ubicación se asocian a la ubicación para mayor claridad y control operativo.
• Dispositivo:Representa los puntos finales de hardware reales, como:
• Cámaras IP Axis
• Grabadores ACS Pro
• Módulos Axis I/O
• Altavoces de bocina Axis

Esta jerarquía garantiza:

• Gestión de configuración limpia
• Enrutamiento preciso de alarmas
• Separación multi‑inquilino
• Informes y visibilidad por sitio
• Incorporación escalable para flotas empresariales más grandes

Paso 5: Seleccionar o crear un Cliente/Sitio

Una vez en la aplicación Configuración:

1. Elija un Cliente/Sitio existente de la lista, o haga clic en Añadir Nuevo para crear un nuevo perfil de cliente y sitio de nivel superior.

Paso 6: Añadir Dispositivos al Sitio

Una vez creado y seleccionado el sitio:

1. Abra la pestaña Dispositivos bajo el sitio.

2. Haga clic en Añadir Nuevo.

3. Elija el tipo de dispositivo Axis que desea añadir:

• Axis Camera Station (para dispositivos ACS Pro)
• Axis (para módulos I/O y cámaras IP)
• Genesis Audio (para altavoces Horn de Axis)

4. El sistema abrirá el asistente de configuración del dispositivo.

Paso 7: Proporcione los detalles del Dispositivo

GCXONE solicitará:

• Nombre
• Dirección IP / Hostname
• Puerto de control
• Usuario y contraseña
• Zona horaria del Dispositivo

Una vez ingresado, haga clic Discover.

Paso 8: Descubrimiento de lista de cámaras

GCXONE recupera automáticamente:

• Lista de cámaras (para ACS Pro o cámara IP, si tiene varios perfiles/vistas)
• Puertos I/O (para módulos I/O)

• Haga clic en Guardar y complete la adición del Dispositivo.
• Se mostrará el Resumen del Dispositivo una vez que se complete el guardado.

• De forma similar para los módulos de E/S de Axis, puede seleccionar Tipo de Dispositivo como "Axis" y el puerto de control como el puerto API de Vapix.

Esto recuperará todas las entradas y salidas disponibles y las añadirá a la lista de E/S del dispositivo.

Para el altavoz de bocina Axis, puede seleccionar el tipo de Dispositivo como "Genesis Audio", asignar un nombre válido y pulsar Descubrir.

Una vez que el altavoz de bocina se descubre y se añade, GCXONE genera automáticamente el nombre de usuario SIP, la contraseña y los detalles del dominio. Estas credenciales deben configurarse en el altavoz de bocina para que pueda registrarse en el punto final SIP y Habilitar audio.

Asegúrese de que los detalles de SIP anteriores estén configurados en el altavoz de corneta ingresando el nombre de usuario, la contraseña y el dominio generados en la página de configuración SIP del Dispositivo y guardando la Configuración. Esto garantiza que el altavoz se registre correctamente en el punto final SIP de GCXONE para la comunicación de audio.

Para verificar que la cámara está transmitiendo correctamente, abra cualquier cámara de la lista de Dispositivos configurada. Debería poder ver la transmisión de video En Vivo sin interrupciones.

En la aplicación Visor de video, puede realizar operaciones de video adicionales como transmisión multi‑cámara, control PTZ, gestión de preajustes, reproducción de grabaciones y más. Simplemente arrastre y suelte el Dispositivo en el área de reproducción, y el Sistema comenzará a mostrar la transmisión en vivo multi‑cámara.

Configuración de Eventos y Reglas

1. GCXONE admite el reenvío de Alarma desde ACS pro mediante Reglas de Acción. Para configurarlo:

• Inicie sesión en el cliente ACS.
• Navegue a la sección de Eventos y abra Reglas de Acción.
• Haga clic en Nueva Regla de Acción para iniciar el asistente de Configuración.
• Elija el disparador de Alarma deseado, como:

Detección de Movimiento

Eventos de Dispositivo

Evento de Entrada/Salida

• Después de seleccionar el disparador, establezca la Acción a "Send HTTP Notification".

• Continúe con el asistente para definir los detalles de la notificación.

Configure los siguientes parámetros en la Notificación HTTP:

• Para configurar el cuerpo de la Solicitud, use la siguiente plantilla JSON. Reemplace los valores de marcador de posición (<<DEVICE_ID_FROM_GENESIS>>, <<CAMERA_ID_FROM_GENESIS>>) con el Device ID y el Camera ID reales, que puede obtener desde la GCXONE Configuration URL.

1. {
2. "initialRequest": {
3. "payload": {
4. "type": "NOTIFICATION",
5. "authenticationToken": "<<DEVICE_ID_FROM_GENESIS>>",
6. "notifications": [
7. {
8. "event": {
9. "type": "ALARM_TRIGGERED",
10. "genesisCamId": "<<CAMERA_ID_FROM_GENESIS>>",
11. "cameraId": "$(TriggerData.SourceId)",
12. "timestamp": "$(TriggerData.TimeUtc)"
13. }
14. }
15. ]
16. }
17. }
18. }

• Puede obtener los valores de marcador de posición directamente desde la URL de configuración.

• Así puede interpretar la URL para extraer los valores de marcador de posición del Device ID y del Camera ID.

Pruebas y verificación

1. Active una regla conocida en ACS Pro (p. ej., alerta de movimiento o de Analítica).
2. En GCXONE, verifique que el evento correspondiente aparezca en Búsqueda de actividad de video o en el panel de alarmas a nivel de Dispositivo.
3. Si no aparecen eventos, confirme la accesibilidad de red a acsproxy.nxgen.cloud/eventIngest y verifique que el Conjunto de acciones esté activo.

Mejores prácticas

1. Siempre pruebe la conectividad con acsproxy.nxgen.cloud/eventIngest antes de guardar.
2. Asegúrese de que el firewall o las políticas de red salientes permitan el tráfico TCP al endpoint de GCXONE.
3. Evite modificar la sintaxis de los marcadores de posición; cualquier carácter incorrecto romperá el análisis JSON.

Visión general del procesamiento de Alarmas

GCXONE ofrece un flujo de trabajo de manejo de alarmas multi‑aplicación diseñado para centros de monitoreo profesionales. Cuando se recibe una alarma de un dispositivo Axis, tres aplicaciones clave trabajan juntas para proporcionar a los operadores una completa conciencia situacional y una capacidad de respuesta rápida.

Aplicación de flujo de trabajo (Manejo de Alarmas)

1. La aplicación Workflow (normalmente la vista de gestión de alarmas Talos) actúa como la consola principal de alarmas del operador.
2. Las alarmas se listan con todos los detalles, incluidos dispositivo, ubicación, cliente, marcas de tiempo, tipo de disparador y gravedad.
3. Los operadores abren una alarma para iniciar la investigación, reconocerla, añadir notas, asignarla o escalarla según sea necesario.
4. Esta aplicación sirve como punto de control central para gestionar todo el ciclo de vida de la alarma.

Aplicación Visor de video (Verificación de Alarmas)

1. Cuando se abre una alarma en la aplicación Workflow, el Visor de video cambia automáticamente al contexto de la alarma correspondiente. Muestra:

• Imagen previa a la alarma
• Imagen de la alarma actual
• Imagen posterior a la alarma.

2. Los operadores también tienen acceso a un conjunto completo de herramientas de video:

• Video En Vivo
• Línea de tiempo de Reproducción
• Control PTZ
• Navegación de preajustes
• Anuncio de audio/Comunicación descendente
• Diseños multi‑cámara

3. Esto brinda a los operadores una confirmación visual inmediata y la capacidad de verificar el evento en tiempo real.

Vista de mapa (Conciencia geoespacial y Control de salidas)

1.La aplicación Mapa muestra todos los dispositivos y salidas posicionados en un mapa interactivo del sitio.

2. Cuando se selecciona una alarma en la aplicación Workflow, la vista de Mapa se centra automáticamente en la ubicación de la alarma.

3.Los operadores pueden interactuar con los dispositivos en el mapa y activar salidas como:

• Sirenas
• Estrobos
• Relés de E/S
• Disparo de clip de audio del grabador a través del altavoz de bocina.

4. Esto brinda a los operadores un acceso rápido a acciones de respuesta directamente en el diseño del sitio.

Flujo de trabajo de operador multi‑monitor

En configuraciones profesionales de sala de control, los operadores suelen usar tres o más monitores. GCXONE está diseñado para soportar este entorno:

Monitor 1: Aplicación de flujo de trabajo

Monitor 2: Visor de video

Monitor 3: Vista de Mapa

Cuando el operador abre una Alarma en la aplicación de flujo de trabajo:

1. El Visor de video en su monitor dedicado cambia automáticamente a la(s) fuente(s) de video de la Alarma.
2. La Vista de Mapa se actualiza simultáneamente para resaltar el sitio y la ubicación del Dispositivo de la Alarma.

Este cambio de contexto sincronizado garantiza que:

1. El operador dispone de una visión holística de 360° de la Alarma.
2. Todas las herramientas relevantes (video, PTZ, audio, mapas, salidas) están accesibles al instante.
3. El tiempo de respuesta se minimiza y la comprensión situacional se maximiza.

Resumen de Características de Integraciones

La plataforma GCXONE se integra con Axis Camera Station Pro mediante una combinación de APIs RESTful, transmisión RTSP y reenvío de eventos basado en webhook. Esta integración permite una gestión, Monitoreo y Analítica unificados para todas las cámaras conectadas.

Resumen

Siguiendo esta guía, puede integrar Axis Camera Station Pro y todo el ecosistema Axis en su plataforma de monitoreo NXGEN. Esta integración unifica:

• Video En Vivo y grabado
• Ingesta de alarmas
• Anuncios de audio
• Control de E/S
• Flujos de trabajo de operador multiaplicación

Resultando en operaciones de Monitoreo integrales, escalables y eficientes.