--- title: "Guía de Integración de la Familia Axis Communications" source: /es/gcxone/devices/axis-communications-family-integration-guide locale: es updated: 2026-09-14 --- ## **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: | Tipo de Dispositivo Axis | Protocolos Compatibles | Propósito | | --- | --- | --- | | Cámaras IP de Red | VAPIX; RTSP/HTTPS; Webhook | Eventos de video; comando y control | | Audio de red, como Altavoces de bocina | VAPIX Audio; Action Rules; SIP | Anuncios; alarmas | | Módulos de Relé I/O de Red | VAPIX I/O; Marco de Eventos | Sensores; relés | | ACS Pro | REST API (internal ACS facade APIs); RTSP | Servicios NVR; búsqueda de video; reproducción; eventos de video; comando y control | 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 ![Guía de Integración de la Familia Axis Communications](/api/media/file/4272a32bc2ed10a31db43d0ce4bd99988ab562ae-1600x1067.png) 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 ![Guía de Integración de la Familia Axis Communications](/api/media/file/da77ef46b545d072f3074552ee1a92ad09502161-1960x1057.png) Flujos de Comunicación | Flujo | Protocolo | Dirección | Notas | | --- | --- | --- | --- | | Transmisión En Vivo/Reproducción | RTSP/HTTPS | CS Pro o cámara IP a NXGEN | GCXONE admite tanto la transmisión redirigida a la nube como Local Mode (eludiendo la nube). | | Eventos | Reglas de acción/Webhooks (HTTPS Push) | Dispositivos Axis a NXGEN | Movimiento; Tamper; I/O; Alarmas del Sistema | | Anuncios de audio | SIP / Genesis Audio | NXGEN a Axis | anuncios en vivo | | Control I/O | Axis HTTPS Digital I/O | NXGEN a Axis | Activar relés/Entradas virtuales | | Comandos y controles | ACS Internal API | NXGEN a Axis | Consultas; Comandos y controles | ## 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. ![Guía de integración de la familia Axis Communications](/api/media/file/bad26788d25d9f70f4068c9d001b75808b40b83f-2261x593.png) **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. ![Guía de integración de la familia Axis Communications](/api/media/file/67aba4327e8b601e9ed4ebf37ec213358d533c81-540x570.png) **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. ![Guía de integración de la familia Axis Communications](/api/media/file/183ed1e93a499760f4668910cd1923bae1807593-680x584.png) **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. ![Axis Communications Family Integration Guide](/api/media/file/92e8cd9693821493fb38711953bc728393cf8e85-1483x891.png) **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**. ![Axis Communications Family Integration Guide](/api/media/file/44836e568c08f0bd42e333a716f03ca82c300dfb-1344x968.png) **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) ![Guía de integración de la familia Axis Communications](/api/media/file/a653239c0897c1b19576b7a71309155e1cc0d866-1337x1037.png) - Haga clic en Guardar y complete la adición del Dispositivo. - Se mostrará el Resumen del Dispositivo una vez que se complete el guardado. ![Guía de integración de la familia Axis Communications](/api/media/file/29e09810511585cfb67987f19bfba3704b24e097-1956x749.png) - 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. ![Guía de integración de la familia Axis Communications](/api/media/file/7d012ab282d638e2b33d54656eeb90d27d3f9c12-1328x968.png) Esto recuperará todas las entradas y salidas disponibles y las añadirá a la lista de E/S del dispositivo. ![Guía de integración de la familia Axis Communications](/api/media/file/af0bbbeb40b0e28e5d952d11241dabe6aff476b9-2459x503.png) Para el altavoz de bocina Axis, puede seleccionar el tipo de Dispositivo como "Genesis Audio", asignar un nombre válido y pulsar Descubrir. ![Guía de integración de la familia Axis Communications](/api/media/file/1ff573dc94ed41c6df7e390ff30c51a8b4411154-1341x776.png) 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. ![Guía de integración de la familia Axis Communications](/api/media/file/e8a111b7f71a3bb4d094e5936d47f97c7884e2b2-513x561.png) 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. ![Axis Communications Family Integration Guide](/api/media/file/edda25e8d139a91b910c0aefad0b027bd730c6d9-660x315.png) ![Guía de integración de la familia Axis Communications](/api/media/file/d5a376d8c4941d8c0fcfa661c90183d55d80dc79-625x227.png) ![Guía de integración de la familia Axis Communications](/api/media/file/cac08412f1bdb32459cbd7c7677d929abd7aa674-594x801.png) 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. ![](/api/media/file/b937e5077d44797eba2791970f594b917e22ee33-1891x794.png) 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. ![Guía de integración de la familia Axis Communications](/api/media/file/027a7ee4601943504f87ed86009b548f739d4280-2532x1254.png) 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 ![Guía de integración de la familia Axis Communications](/api/media/file/fd69c92d75455d08ba825ace6783543604bc8920-1193x760.png) - Después de seleccionar el disparador, establezca la Acción a "Send HTTP Notification". ![Guía de integración de la familia Axis Communications](/api/media/file/7bc5777d1157dacf22102ad1856877c53731bb85-1243x890.png) - Continúe con el asistente para definir los detalles de la notificación. ![Guía de integración de la familia Axis Communications](/api/media/file/f9469cf9afeac22208a852bfcbaeabc0ba1d8a36-859x873.png) Configure los siguientes parámetros en la Notificación HTTP: | Parámetro | Valor | Descripción | | --- | --- | --- | | URL | https://acsproxy.nxgen.cloud/eventIngest | genesis webhook endpoint | | Método | POST | Método HTTP | | Tipo de contenido | application/json | Formato de carga útil | - Para configurar el cuerpo de la Solicitud, use la siguiente plantilla JSON. Reemplace los valores de marcador de posición (`<>, <>`) 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": "<>",` 6. `"notifications": [` 7. `{` 8. `"event": {` 9. `"type": "ALARM_TRIGGERED",` 10. `"genesisCamId": "<>",` 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. ![Axis Communications Family Integration Guide](/api/media/file/6679ff8505a5d4bb7f884534d48490474b2c5ed3-2072x862.png) - Así puede interpretar la URL para extraer los valores de marcador de posición del Device ID y del Camera ID. ![Axis Communications Family Integration Guide](/api/media/file/38fef39f862e363e032643c47c8e818ee966b2ae-1862x84.png) 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 [https://acsproxy.nxgen.cloud/eventIngest](https://acsproxy.nxgen.cloud/eventIngest) y verifique que el Conjunto de acciones esté activo. Mejores prácticas 1. Siempre pruebe la conectividad con [https://acsproxy.nxgen.cloud/eventIngest](https://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 ![Guía de integración de la familia Axis Communications](/api/media/file/5ebcf4007b7c181930a40c41190e5e06ff83e9a7-2476x1246.png) Monitor 2: Visor de video ![Guía de integración de la familia Axis Communications](/api/media/file/87a3521455df686fb071f66ce078fdc96c6967f8-2545x1304.png) Monitor 3: Vista de Mapa ![Guía de integración de la familia Axis Communications](/api/media/file/b4539c0a73f00e54f4528464c801f817e10250d2-2543x1300.png) 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. | Característica | Descripción | API/Protocolo utilizado | Estado de integración de GCXONE | | --- | --- | --- | --- | | Descubrimiento de Dispositivo | Recupera automáticamente la lista de cámaras configuradas del VMS ACS Pro. | API | ✅ Integrado | | Stream en Directo | Proporciona transmisión de video en tiempo real desde cámaras conectadas al VMS ACS Pro para Monitoreo en Vivo. | RTSP | ✅ Integrado | | Stream de Reproducción | Permite el acceso a grabaciones o metraje histórico del archivo de video de Axis. | RTSP | ✅ Integrado | | Control de línea de tiempo | Muestra la línea de tiempo de video grabado para cada cámara; permitiendo un desplazamiento fluido y control de reproducción. | API | ✅ Integrado | | Control de PTZ y preajustes | Permite el control de paneo, inclinación y zoom de cámaras compatibles; y la capacidad de activar preajustes PTZ predefinidos. | API | ✅ Integrado | | Alarmas | Reenvía notificaciones de eventos en tiempo real (analítica; sistema; o alarmas basadas en reglas) a GCXONE usando Action Sets | HTTP Webhook | ✅ Integrado | | Audio | Anuncio de audio en tiempo real a través de Axis Horn Speaker | SIP | ✅ Integrado | ## **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.