GCXONEDocumentación

Guía de Integración del Robot Ascento

Actualizado el 29 de septiembre de 2026Dispositivos e integracionesDescargar PDF
Usar con IA
Sugerir un cambioObtener ayuda
En esta página
  1. Introducción
  2. Visión general del sistema
  3. Arquitectura del sistema
  4. General de Configuración
  5. Configuración del robot Ascento
  6. Configuración de Eventos y Reglas
  7. Configuración de regla de alarma personalizada
  8. Visión general del procesamiento de alarmas
  9. Flujo de trabajo del operador con varios monitores
  10. Resumen de Características de Integraciones

Introducción

El robot Ascento es un robot de Seguridad autónomo que lleva cinco cámaras. Esta guía explica cómo se conecta a GCXONE y qué puede ver y hacer una vez que está en funcionamiento.

Una vez que el robot está conectado, GCXONE le brinda:

  • Video En Vivo de las cinco cámaras del robot — frontal, trasera, izquierda, derecha y una cámara térmica.
  • Alarmas de detección generadas mientras el robot patrulla, como personas y vehículos. Cada una llega con imágenes y un recuadro dibujado alrededor de lo detectado.
  • Alertas técnicas sobre el propio robot — batería baja, estado de carga, salida de su zona segura, cambios en el foco y luz de emergencia, y pérdida de comunicación.
  • Control de luces — encienda o apague el foco y la luz de emergencia del robot.

Visión general del sistema

Tipo de Dispositivo Ascento

Protocolos compatibles

Propósito

Robot de Seguridad Autónomo

REST API; WebSocket; RTSP/WebRTC

Gestión del robot; video En Vivo; telemetría; comando y control

Cámaras del Robot

RTSP/WebRTC

Transmisión de video En Vivo; grabación; monitoreo remoto

Telemetría del Robot

REST API; WebSocket

Estado de batería; ubicación GPS; rumbo; salud del robot; estado de carga

Eventos y Alarmas del Robot

WebSocket (o sondeo REST; según la implementación)

Alarmas de batería; eventos de geocerca; parada de emergencia; notificaciones de fallas; estado de misión

Iluminación y Señalización del Robot

REST API

Control de focos; luces de emergencia; indicadores

Base de Carga del Robot

REST API

Estado de acoplamiento; estado de carga; control de carga

GCXONE se conecta a la nube Ascento para recibir:

  • Transmisión de video En Vivo
  • Alarmas y eventos
  • Cambios en el estado del robot

Arquitectura del sistema

Flujos de Comunicación

Flujo

Protocolo

Dirección

Notas

Stream en Directo

RTSP

Ascento to NXGEN

Genesis admite tanto la retransmisión en la nube como el modo local (evadiendo la nube).

Eventos

Reglas de Acción/MQTT Push

Ascento to NXGEN

Detección como eventos de Movimiento; Estado como eventos Técnicos

Anuncios de Audio

SIP / Genesis Audio

NXGEN to Ascento

anuncios en vivo

Control I/O

REST API

NXGEN to Ascento

Activar/Desactivar relés/entradas virtuales para encender/apagar las luces

Comandos y Controles

API Interna Ascento

NXGEN to Ascento

Consultas; Comandos y Controles

General de Configuración

Requisitos Previos a la Integración

Requisito

Propósito

Credenciales API

Requerido para acceder a las APIs REST de Ascento usando el nombre de usuario y la contraseña proporcionados, y para acceder a todas las APIs disponibles.

Robot ID(s)

Requerido para obtener un robot/dispositivo concreto y ejecutar acciones necesarias como video en directo; control de relés; y recuperación de eventos.

ID de Organización

Requerido para comunicarse con los servicios de eventos y obtener información detallada de los eventos.

Nombre de Organización

Requerido para establecer la conexión MQTT y configurar el flujo de eventos.

Certificado Raíz CA

Requerido para establecer una conexión MQTT segura y validar el certificado del broker.

Certificado

Requerido para la autenticación del cliente al establecer la conexión MQTT.

Certificado de clave privada

Requerido junto con el Certificado para establecer la conexión MQTT de forma segura.

Configuración del robot Ascento

Paso 1: Iniciar sesión en la plataforma GCXONE

  • Abra la URL de GCXONE en un navegador.
  • Inicie sesión con sus credenciales de administrador o integrador.
  • Después de iniciar sesión, GCXONE carga el entorno para su inquilino.
imagen

Paso 2: Seleccione su organización

Si su inquilino tiene más de una organización, GCXONE le pregunta cuál desea gestionar.

  • Más de una organización — elija la que desee en la pantalla de selección.
  • Solo una organización — GCXONE la abre para usted y lo lleva directamente al panel de control.
imagen

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

  • En el panel de Aplicaciones a la izquierda, localice el Configuración icono.
  • Haga clic en Configuración para abrir el espacio de trabajo de configuración.
  • Se abre la pantalla de configuración. Aquí gestiona Clientes, Ubicaciones y Dispositivos.
imagen

Paso 4: Comprender la jerarquía de configuración

GCXONE organiza todo en un orden fijo: Cliente → Ubicación → Dispositivo → Cámaras/Sensores.

Cómo funciona esta jerarquía

  • Cliente — la empresa o cliente en la parte superior. Un cliente posee una o más ubicaciones.
  • Ubicación — un lugar, como una oficina, almacén o tienda minorista. Cada Dispositivo en esa ubicación pertenece a su Ubicación.
  • Dispositivo — el hardware en sí, como un robot Ascento. Sus Cámaras y Sensores se encuentran bajo él.

Mantener este orden garantiza que las Alarmas se enruten al lugar correcto, que los datos de cada Cliente permanezcan separados y que los informes funcionen por Ubicación.

Paso 5: Seleccione o cree un Cliente/Ubicación

En la aplicación Configuración:

  • Elija un cliente y una ubicación existentes de la lista, o haga clic en Agregar nuevo para crearlos.
imagen

Paso 6: Añadir Dispositivos al Sitio

Con el sitio seleccionado:

  • Abra elDispositivos pestaña bajo el sitio.
  • Haga clic Añadir Nuevo.
  • Elija el tipo de dispositivo que desea añadir:
  • Ascento
  • Se abre el asistente de configuración del dispositivo.
imagen

Añada los siguientes detalles de configuración para la integración Ascento:

  1. Robo ID – Identificador único del robot Ascento.
  2. Nombre de usuario – Nombre de usuario de Ascento Cloud utilizado para autenticarse con la API REST de Ascento. Un conjunto de credenciales en la nube se aplica a todos los dispositivos de la misma organización.
  3. Contraseña – Contraseña de Ascento Cloud utilizada para autenticarse con la API REST de Ascento.
  4. URL de Alarma – Autocompletado automáticamente para recibir notificaciones de alarma y eventos (no se requiere aporte).
  5. Identificación única de la Organización – Solo lectura. Rellenado automáticamente y usado para obtener información detallada de eventos.
  6. Nombre de la Organización – Solo lectura. Rellenado automáticamente y usado para establecer la conexión MQTT y el flujo de eventos.
  7. Zona segura en metros – Opcional. Distancia del perímetro de zona segura alrededor del robot.
  8. Zona horaria – Obligatorio. La zona horaria en la que opera el robot, por ejemplo Europe/Zurich.

Configuración de certificado

Los campos de certificado se mostrarán automáticamente después del descubrimiento del dispositivo. Si se requieren actualizaciones, los certificados pueden editarse y cargarse.

  1. Certificado raíz CA – Utilizado para verificar el certificado del broker MQTT.
  2. Certificado – Utilizado para la autenticación del cliente durante la conexión MQTT.
  3. Certificado de clave privada – Utilizado junto con el Certificado para establecer una conexión MQTT segura.

Estos archivos de certificado se necesitan una vez por organización. Si ya ha importado estos certificados para otro dispositivo Robot en la misma organización, se reutilizarán — no es necesario importarlos de nuevo.

El cuadro de diálogo también contiene tres secciones adicionales: Configuración del Dispositivo (Configuración de Site Pulse); Ajustes avanzados (Sondeo de eventos, Configurar Máscara de mapa de calor, Control de salud periódico y Tiempo de retención de eventos, que por defecto es 30 días); y Ubicación (Latitud, Longitud, Código Plus y What 3 Words).

Puede encontrar el Robo ID en el portal web Ascento. Consulte la captura de pantalla a continuación.

Una vez introducido, haga clic en Descubrir. Tras un descubrimiento exitoso el cuadro de diálogo muestra Cerrar, Redescubrir, y Guardar.

Paso 7: Descubrimiento de lista de Cámaras

GCXONE recupera el robot:

  • Lista de cámaras
  • Puertos de control (como luces de emergencia, focos, etc..)

Cada robot Ascento se descubre con las mismas cinco cámaras fijas: delantera, trasera, izquierda, derecha y una cámara térmica (listada como thermal -Thermal). Aparecen en el panel Cámaras conectadas (5/5 activado) del cuadro de diálogo del Dispositivo y en la Visión general del Dispositivo como Sensores activos 5/5.

Haga clic en Guardar para finalizar la incorporación del Dispositivo. Se abre la Visión general del Dispositivo.

Para comprobar que el video funciona, abra cualquier cámara de la lista de Dispositivos. El Stream en Directo debería reproducirse sin interrupciones.

También puede ver varias cámaras a la vez. En el Visor de video, arrastre el Dispositivo al área de reproducción y todas sus cámaras comenzarán a transmitir simultáneamente.

Configuración de Eventos y Reglas

El robot envía dos tipos de alarmas.

\1. Alarmas de estado

Alarmas de estado le informan sobre la condición del propio robot, y GCXONE las gestiona como alarmas técnicas. Las ve:

  • En el panel del Dispositivo
  • En Talos, la aplicación de gestión de alarmas

El robot informa de los siguientes valores, y las reglas de alarma que configure los convierten en alarmas técnicas:

Batería

  • Estado de carga (SoC)
  • Estado de carga

Posición

  • Dirección
  • Latitud
  • Longitud

\2. Búsqueda de alarmas

Búsqueda de alarmas son lo que el robot detecta a su alrededor, como una persona o un vehículo. GCXONE los gestiona como eventos de movimiento, y usted los ve:

  • En Búsqueda de actividad de video (VAS), donde puede buscar eventos pasados
  • En Talos, la aplicación de gestión de alarmas

Cada evento de búsqueda se abre en la vista estándar de evento, que muestra:

  • Cuatro paneles — Pré-alarma, Alarma, Post-alarma y una Vista previa en vivo.
  • Cuadros delimitadores que resaltan el objeto detectado.
  • Una insignia de clasificación como ALARMA real.
  • Pulse A y D para desplazarse entre eventos.

El Campos de eventos del Dispositivo tabla en la página del Dispositivo enumera cada evento recibido, con las columnas Tiempo, TIPO DE EVENTO, Análisis de Genesis, Zona, Nombre de Cámara, Índice, Alarma/Restaurar, Tipo de Dispositivo, Tipo de Cámara, Duración de Imágenes, Duración de Analítica, Duración Total y Imágenes en Evento. Los eventos aparecen con sus códigos sin procesar — eventos de movimiento como analytics.people.* y vehicle.alert, y eventos técnicos como robot.battery.soc.warning. La columna Análisis de Genesis clasifica cada evento como REAL, REDUNDANTE o TÉCNICA, y la columna Alarma/Restaurar indica si el evento generó o restauró la condición.

Configuración de regla de alarma personalizada

Las alarmas de estado no se generan por sí solas. Usted decide cuándo el robot debe alertarle — por ejemplo, por debajo de qué nivel de batería, o a qué distancia puede viajar de su zona segura — configurando Reglas de alarma personalizadas en el Dispositivo:

Diálogo de edición del dispositivo → Propiedades → Reglas de alarma personalizadas

GCXONE compara los valores que reporta el robot con estas reglas y genera una alarma técnica siempre que se cumpla una.

Haga clic Ver/Editar JSON, pegue las reglas de alarma Ascento, guarde el diálogo y, a continuación, guarde el Dispositivo.

json
{
  "Ascento": {
    "battery": {
      "stateOfCharge": {
        "active": false,
        "low": 20,
        "eventCode": "robot.battery.soc.warning",
        "groupCode": "robot.battery.soc.alert"
      },
      "charging": {
        "active": false,
        "expectedCharging": false,
        "eventCode": "robot.battery.charging.statechange",
        "groupCode": "robot.battery.charging.alert"
      }
    },
    "location": {
      "geoFence": {
        "active": false,
        "radiusMeters": 500,
        "eventCode": "robot.geofence.breach",
        "groupCode": "robot.location.geofence.alert"
      }
    },
    "spotLightsEnabled": {
      "active": false,
      "alertOn": true,
      "eventCode": "robot.spotlight.statechange",
      "groupCode": "robot.spotlight.alert"
    },
    "hazardLightsEnabled": {
      "active": false,
      "alertOn": true,
      "eventCode": "robot.hazardlight.statechange",
      "groupCode": "robot.hazardlight.alert"
    },
    "communication": {
      "offline": {
        "active": false,
        "timeoutSeconds": 30,
        "eventCode": "robot.communication.lost",
        "groupCode": "robot.communication.alert"
      }
    }
  }
}

Visión general del procesamiento de alarmas

Cuando llega una alarma del robot, tres aplicaciones de GCXONE trabajan conjuntamente para que el operador vea la información completa a la vez: los detalles de la alarma, el video y la ubicación en el mapa.

\1. Talos — gestión de la alarma

Talos es la consola principal de alarmas del operador.

  • Cada alarma se enumera con su Dispositivo, Ubicación, Cliente, hora, tipo de disparo y gravedad.
  • Abra una alarma para investigarla, reconocerla, añadir notas, asignarla o escalarla.

La alarma se gestiona desde aquí desde el momento en que llega hasta que se cierra.

\2. Visor de video — comprobación de lo ocurrido

En cuanto abre una alarma en Talos, el Visor de video cambia a esa alarma y muestra:

  • Imagen de pré-alarma
  • Imagen de alarma actual
  • Imagen posterior a la alarma.

También dispone del conjunto completo de herramientas de video:

  • Video En Vivo
  • Control de Dispositivo
  • Diseños de múltiples cámaras

Esto le permite confirmar lo ocurrido de inmediato.

\3. Mapa — ver dónde ocurrió y responder

El Mapa muestra cada Dispositivo en un mapa interactivo del sitio. Cuando selecciona una Alarma en Talos, el mapa se centra en el origen.

Desde el mapa puede actuar directamente sobre el robot y encender o apagar sus luces:

  • Luces de foco
  • Luces de advertencia

De modo que puede responder desde la misma pantalla que ya está viendo.

Flujo de trabajo del operador con varios monitores

Las salas de control suelen usar tres o más monitores, y GCXONE está diseñado para ello:

  • Monitor 1 — Talos
imagen
  • Monitor 2 — Visor de video
imagen
  • Monitor 3 — Mapa
imagen

Al abrir una Alarma en el primer monitor, los otros dos la siguen automáticamente:

  • El Visor de video cambia a las cámaras de esa Alarma.
  • El Mapa resalta el sitio y el Dispositivo del que proviene la Alarma.

Obtiene la Alarma, el video y la ubicación lado a lado sin abrir nada manualmente, lo que le permite decidir y responder más rápido.

Resumen de Características de Integraciones

GCXONE se conecta a la nube Ascento mediante sus REST APIs para datos y control del robot, RTSP para video en vivo y una suscripción para alarmas y eventos. Todo lo que envía el robot se gestiona en GCXONE junto a sus demás Dispositivos.

¿Le ha resultado útil esta página?

Gracias — sus comentarios llegan al equipo responsable de esta página.

Notas de versión

Entérese cuando se publique algo nuevo

Nuevas funciones, correcciones y actualizaciones de integraciones de GCXONE, en su bandeja de entrada en cuanto se publican.

Primero enviamos un enlace de confirmación. Cada mensaje incluye un enlace para darse de baja.