--- title: "Ascento Robot Integrationshandbuch" source: /de/gcxone/devices/ascento locale: de updated: 2026-09-29 --- ## **Einleitung** Der Ascento‑Roboter ist ein autonomer Sicherheitsroboter, der fünf Kameras trägt. Dieses Handbuch erklärt, wie er an GCXONE angebunden wird und was Sie sehen und tun können, sobald er läuft. Sobald der Roboter verbunden ist, stellt Ihnen GCXONE Folgendes bereit: - **Live‑Video** von den fünf Kameras des Roboters – vorne, hinten, links, rechts und einer Wärmebildkamera. - **Erkennungs‑Alarme** die während der Patrouille des Roboters ausgelöst werden, z. B. Personen‑ und Fahrzeug‑Alarme. Jeder Alarm wird mit Bildern und einer um das Erfasste gezeichneten Box geliefert. - **Technische Warnungen** zum Roboter selbst – niedriger Batteriestand, Ladezustand, Verlassen der Sicherheitszone, Änderungen der Spotlight‑ und Gefahrlicht‑Anzeige sowie Kommunikationsverlust. - **Lichtsteuerung** – Spotlight und Gefahrlicht des Roboters ein- oder ausschalten. ## **System‑Überblick** | Ascento Gerätetyp | Unterstützte Protokolle | Zweck | | --- | --- | --- | | Autonomer Sicherheitsroboter | REST API; WebSocket; RTSP/WebRTC | Roboterverwaltung; Live‑Video; Telemetrie; Befehls‑ und Steuerung | | Roboter‑Kameras | RTSP/WebRTC | Live‑Video‑Streaming; Aufzeichnung; Fern‑Überwachung | | Roboter‑Telemetrie | REST API; WebSocket | Batteriestatus; GPS‑Position; Kurs; Roboter‑Gesundheit; Ladezustand | | Roboter‑Ereignisse & Alarme | WebSocket (oder REST‑Polling; je nach Einsatz) | Batterie‑Alarme; Geofence‑Ereignisse; Not‑Stopp; Fehlermeldungen; Missionsstatus | | Roboter‑Beleuchtung & Signalisierung | REST API | Spotlights steuern; Gefahrlichter; Anzeigen | | Roboter‑Ladestation | REST API | Dock‑Status; Lade‑Status; Ladesteuerung | GCXONE verbindet sich mit der Ascento‑Cloud, um Folgendes zu erhalten: - Live‑Video‑Streaming - Alarme und Ereignisse - Änderungen des Roboter‑Status ![](/api/media/file/c17b8989fb6487bcfb3582fc430b64a18a33eda4-560x420.png) ## **Systemarchitektur** ![](/api/media/file/70b8c8b7243f2f3a426612b6351e170576779b90-1210x597.png) ### Kommunikationsflüsse | Fluss | Protokoll | Richtung | Notizen | | --- | --- | --- | --- | | Live-Übertragung | RTSP | Ascento zu NXGEN | Genesis unterstützt sowohl cloud-umgeleitetes Streaming als auch den Local Mode (Umgehung der Cloud). | | Ereignisse | Regeln/Aktionen MQTT Push | Ascento zu NXGEN | Erkennung als Bewegungsereignisse; Status als Technische Ereignisse | | Audioansagen | SIP / Genesis Audio | NXGEN zu Ascento | Live‑Ansagen | | I/O‑Steuerung | REST API | NXGEN zu Ascento | Relais/virtuelle Eingänge auslösen, um das Licht ein-/auszuschalten | | Befehle und Steuerungen | Ascento Internal API | NXGEN zu Ascento | Abfragen; Befehle und Steuerungen | ## **Konfigurations‑Überblick** ### Vor‑Integrationsanforderungen | Anforderung | Zweck | | --- | --- | | API‑Anmeldeinformationen | Erforderlich, um mit den bereitgestellten Benutzernamen und Passwort auf die Ascento REST APIs zuzugreifen und alle verfügbaren APIs zu nutzen. | | Robo‑ID(s) | Erforderlich, um ein bestimmtes Robot/Device abzurufen und notwendige Aktionen wie Live‑Video, Relaissteuerung und Ereignisabruf durchzuführen. | | Organisations‑ID | Erforderlich, um mit den Ereignisdiensten zu kommunizieren und detaillierte Ereignisinformationen abzurufen. | | Organisationsname | Erforderlich, um die MQTT‑Verbindung herzustellen und den Ereignisfluss zu konfigurieren. | | CA‑Root‑Zertifikat | Erforderlich, um eine sichere MQTT‑Verbindung aufzubauen und das Broker‑Zertifikat zu validieren. | | Zertifikat | Erforderlich für die Client-Authentifizierung beim Aufbau der MQTT-Verbindung. | | Privater Schlüssel Zertifikat | Erforderlich zusammen mit dem Zertifikat, um die MQTT-Verbindung sicher aufzubauen. | ## Ascento Robot-Konfiguration ### Schritt 1: Einloggen in die GCXONE-Plattform - Öffnen Sie die GCXONE-URL in einem Browser. - Melden Sie sich mit Ihren Administrator- oder Integrator-Anmeldedaten an. - Nachdem Sie sich angemeldet haben, lädt GCXONE die Umgebung für Ihren Mandanten. ![Bild](/api/media/file/0eb08492464d3636d11ea45778c834d67788557b-576x414.png) ### Schritt 2: Wählen Sie Ihre Organisation Wenn Ihr Mandant mehr als eine Organisation hat, fragt GCXONE, welche Sie verwalten möchten. - **Mehr als eine Organisation** — wählen Sie die gewünschte aus dem Auswahlbildschirm. - **Nur eine Organisation** — GCXONE öffnet sie für Sie und springt direkt zum Dashboard. ![Bild](/api/media/file/5e024779b10abf8866fa2f0a9b7f298fc600c927-560x607.png) ### Schritt 3: Navigieren Sie zur Konfiguration‑App - Im linken Apps‑Panel finden Sie das **Konfiguration** Symbol. - Klicken Sie auf **Konfiguration** um den Konfigurationsarbeitsbereich zu öffnen. - Der Konfigurationsbildschirm öffnet sich. Hier verwalten Sie Kunden, Standorte und Geräte. ![Bild](/api/media/file/7469ef0d61ce9d54c49ba188a44a67fcd2189cdb-680x584.png) ### Schritt 4: Verständnis der Konfigurationshierarchie GCXONE organisiert alles in einer festen Reihenfolge: Kunde → Standort → Gerät → Kameras/Sensoren. Wie diese Hierarchie funktioniert - **Kunde** — das Unternehmen oder der Kunde an der Spitze. Ein Kunde besitzt einen oder mehrere Standorte. - **Standort** — ein Ort, z. B. ein Büro, Lagerhaus oder Einzelhandelsgeschäft. Jedes Gerät an diesem Ort gehört zu diesem Standort. - **Gerät** — die Hardware selbst, z. B. ein Ascento‑Roboter. Seine Kameras und Sensoren sind darunter angeordnet. Die Einhaltung dieser Reihenfolge sorgt dafür, dass Alarme an die richtige Stelle geleitet werden, die Daten jedes Kunden getrennt bleiben und Berichte standortweise funktionieren. ### Schritt 5: Einen Kunden/Standort auswählen oder erstellen In der Konfiguration‑App: - Wählen Sie einen bestehenden Kunden und Standort aus der Liste oder klicken Sie auf **Neu hinzufügen** um sie zu erstellen. ![Bild](/api/media/file/6027c395e4784f55836992208dc7d4523dcc4efa-1483x891.png) ### Schritt 6: Geräte zum Site hinzufügen Mit dem ausgewählten Site: - Öffnen Sie das **Geräte** Registerkarte unter dem Site. - Klicken Sie auf **Neu hinzufügen**. - Wählen Sie den Gerätetyp, den Sie hinzufügen möchten: - **Ascento** - Der Geräte-Konfigurationsassistent öffnet sich. ![Bild](/api/media/file/1e94f8771e2dcafe6d080b7a365863439e413afa-1704x852.png) ![](/api/media/file/fd6e4aaadd2c977a89438e8792b75e62a67e9f47-1397x811.png) Fügen Sie die folgenden Konfigurationsdetails für die Ascento-Integration hinzu: 1. **Robo ID** – Eindeutiger Bezeichner des Ascento‑Roboters. 2. **Nutzername** – Ascento‑Cloud‑Nutzername zur Authentifizierung bei der Ascento‑REST‑API. Ein Satz Cloud‑Anmeldedaten gilt für alle Geräte in derselben Organisation. 3. **Passwort** – Ascento‑Cloud‑Passwort zur Authentifizierung bei der Ascento‑REST‑API. 4. **Alarm URL** – Wird automatisch vorausgefüllt, um Alarm‑ und Ereignisbenachrichtigungen zu erhalten (keine Eingabe erforderlich). 5. **Organization ID** – Nur lesbar. Wird automatisch gefüllt und dient zum Abrufen detaillierter Ereignisinformationen. 6. **Organization Name** – Nur lesbar. Wird automatisch gefüllt und dient zum Aufbau der MQTT‑Verbindung und des Ereignisflusses. 7. **SafeZone in Metern** – Optional. Abstand des Sicherheitszonen‑Umfangs um den Roboter. 8. **Zeitzone** – Erforderlich. Die Zeitzone, in der der Roboter arbeitet, z. B. Europe/Zurich. ### Zertifikatskonfiguration Die Zertifikatsfelder werden nach der Geräteerkennung automatisch angezeigt. Falls Aktualisierungen erforderlich sind, können die Zertifikate bearbeitet und hochgeladen werden. 1. **CA‑Root‑Zertifikat** – Wird verwendet, um das Zertifikat des MQTT‑Brokers zu prüfen. 2. **Zertifikat** – Wird für die Client‑Authentifizierung während der MQTT‑Verbindung verwendet. 3. **Privater Schlüssel‑Zertifikat** – Wird zusammen mit dem Zertifikat verwendet, um eine sichere MQTT‑Verbindung aufzubauen. Diese Zertifikatsdateien werden einmal pro Organisation benötigt. Wenn Sie diese Zertifikate bereits für ein anderes Robot‑Gerät in derselben Organisation importiert haben, werden sie wiederverwendet – ein erneuter Import ist nicht nötig. Der Dialog enthält außerdem drei weitere Abschnitte: **Geräte‑Konfiguration** (Site Pulse Konfiguration); **Erweiterte Einstellungen** (Ereignisabfrage, Heatmap‑Maske konfigurieren, Periodische Statusabfrage und Ereignis Haltezeit, standardmäßig 30 Tage); und **Standort** (Breitengrad, Längengrad, Plus‑Code und What 3 Words). Sie finden die Robo‑ID im Ascento Web‑Portal. Siehe den untenstehenden Screenshot. ![image](/api/media/file/b9ffe07232313f81dc4787e5ac5500ab965bd5a1-560x615.png) Nach Eingabe klicken Sie **Suche**. Nach erfolgreicher Suche zeigt der Dialog **Schließen**, **Erneut suchen**, und **Speichern**. ### Schritt 7: Kamera‑Liste entdecken GCXONE ruft die Daten des Roboters ab: - Kamera‑Liste - Kontrol‑Ports (wie Gefahrenlichter, Spotlights usw.) Jeder Ascento‑Roboter wird mit denselben fünf festen Kameras entdeckt: vorne, hinten, links, rechts und einer Thermalkamera (aufgeführt als thermal‑Thermal). Sie erscheinen im Feld Verbundene Kameras (5/5 aktiviert) des Gerätedialogs und im Geräte‑Überblick als Aktive Sensoren 5/5. ![image](/api/media/file/b245be0e264e9b1e17dd133fb13b5dec080e521a-1542x900.png) Klicken Sie **Speichern**, um das Gerät hinzuzufügen. Der Geräte‑Überblick öffnet sich. ![image](/api/media/file/07b9717cbd410d031003afa195e4662e23b34b6e-1866x390.png) Um zu prüfen, ob das Video funktioniert, öffnen Sie eine beliebige Kamera aus der Geräteliste. Die Live‑Übertragung sollte ohne Unterbrechung laufen. Sie können auch mehrere Kameras gleichzeitig ansehen. Ziehen Sie im Video‑Viewer das Gerät in den Wiedergabebereich, und alle seine Kameras starten gleichzeitig zu streamen. ![image](/api/media/file/a531c09d0de6e4887130a1cd9ebf6fdb0005a9e7-2532x1254.png) ## **Ereignisse und Regeln Konfiguration** Der Roboter sendet zwei Arten von Alarm. ### \\1. Status‑Alarme **Status‑Alarme**informieren über den Zustand des Roboters selbst, und GCXONE behandelt sie als technische Alarme. Sie sehen sie: - Im Gerät‑Dashboard - In Talos, der Alarm‑Handling‑Anwendung Der Roboter meldet die folgenden Werte, und die von Ihnen konfigurierten Alarmregeln wandeln sie in technische Alarme um: #### Batterie - Ladezustand (SoC) - Ladestatus #### Pose - Richtung - Breitengrad - Längengrad ### \\2. Alarme finden **Alarme finden**Detektionen sind das, was der Roboter in seiner Umgebung erkennt, z. B. eine Person oder ein Fahrzeug. GCXONE behandelt sie als Bewegungsereignisse, und Sie sehen sie: - In der Video‑Aktivitätssuche (VAS), wo Sie vergangene Ereignisse durchsuchen können - In Talos, der Alarm‑Verarbeitungsanwendung Jedes Finding‑Ereignis öffnet sich in der Standard‑Ereignisanzeige, die Folgendes anzeigt: - Vier Bereiche — Voralarm, Alarm, Nachalarm und eine Live‑Vorschau. - Begrenzungsrahmen, die das erkannte Objekt hervorheben. - Ein Klassifizierungsbadge wie ECHTER ALARM. - Drücken Sie A und D, um zwischen Ereignissen zu wechseln. Der **Geräte‑Ereignis‑Felder**Die Tabelle auf der Geräteseite listet jedes empfangene Ereignis auf, mit den Spalten Zeit, ERREIGNISTYP, Genesis‑Analyse, Zone, Kameraname, Index, Alarm/Wiederherstellung, Gerätetyp, Kameratyp, Bilddauer, Analytikdauer, Gesamtdauer und Bilder im Ereignis. Ereignisse erscheinen mit ihren Rohcodes – Bewegungsereignisse wie analytics.people.\* und vehicle.alert sowie technische Ereignisse wie robot.battery.soc.warning. Die Spalte Genesis‑Analyse klassifiziert jedes Ereignis als ECHTER, REDUNDANT oder TECHNISCH, und die Spalte Alarm/Wiederherstellung zeigt, ob das Ereignis den Zustand ausgelöst oder wiederhergestellt hat. ## **Benutzerdefinierte Alarmregel‑Konfiguration** Statusalarme werden nicht von selbst ausgelöst. Sie entscheiden, wann der Roboter Sie warnen soll – zum Beispiel bei welchem Batteriestand oder wie weit er von seiner Sicherheitszone entfernt reisen darf – indem Sie benutzerdefinierte Alarmregeln am Gerät festlegen: Geräte‑Bearbeitungsdialog → Einstellungen → Benutzerdefinierte Alarmregeln GCXONE prüft die vom Roboter gemeldeten Werte gegen diese Regeln und löst einen technischen Alarm aus, sobald eine Regel erfüllt ist. ![image](/api/media/file/44a3417471dad498a234425850ab0c861a573a6a-1707x829.png) Klicken Sie **JSON anzeigen/bearbeiten**, fügen Sie die Ascento‑Alarmregeln ein, speichern Sie den Dialog und anschließend das Gerät. ```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" } } } } ``` ![image](/api/media/file/77c59a8561329da59193f29d23c36abfdb6ee3e4-1037x510.png) ![image](/api/media/file/cd41eb2825c9daff0047f76f2393050e1a2f987c-1834x935.png) ## **Übersicht Alarmverarbeitung** Wenn ein Alarm vom Roboter eintrifft, arbeiten drei GCXONE‑Anwendungen zusammen, sodass der Bediener das Gesamtbild sofort sieht: die Alarmdetails, das Video und den Standort auf der Karte. ### **\\1. Talos – Verarbeitung des Alarms** Talos ist die Haupt‑Alarmkonsole des Bedieners. - Jeder Alarm wird mit seinem Gerät, Standort, Kunden, Zeit, Auslösertyp und Schweregrad aufgelistet. - Öffnen Sie einen Alarm, um ihn zu untersuchen, zu bestätigen, Notizen hinzuzufügen, ihn zuzuweisen oder zu eskalieren. Der Alarm wird hier vom Eintreffen bis zum Schließen verwaltet. ### **\\2. Video‑Viewer – Überprüfung des Geschehens** Sobald Sie einen Alarm in Talos öffnen, schaltet der Video‑Viewer zu diesem Alarm um und zeigt: - Voralarm‑Bild - Aktueller‑Alarm‑Bild - Nach-Alarm-Bild. Sie haben außerdem das komplette Set an Videowerkzeugen: - Live-Video - Gerätesteuerung - Mehrkamera‑Layouts Damit können Sie sofort bestätigen, was passiert ist. ### **\\3. Karte — sehen, wo es passiert ist, und reagieren** Die Karte zeigt jedes Gerät auf einer interaktiven Standortkarte. Wenn Sie einen Alarm in Talos auswählen, zentriert die Karte den Ort, von dem er stammt. Über die Karte können Sie direkt am Roboter agieren und dessen Lichter ein- oder ausschalten: - Spotlights - Gefahrenlichter So können Sie vom selben Bildschirm aus reagieren, den Sie bereits betrachten. ## **Mehrmonitor‑Operator‑Workflow** Leitstellen verwenden in der Regel drei oder mehr Monitore, und GCXONE ist dafür ausgelegt: - Monitor 1 — Talos ![image](/api/media/file/34cda4a60b65c6425c367774e4ad8588af577ec6-2476x1246.png) - Monitor 2 — Video‑Viewer ![image](/api/media/file/fe761fec02217025fdaf1ffb1796021e53323814-2545x1304.png) - Monitor 3 — Karte ![image](/api/media/file/f34cbe83f8243611dc90fdb8af967902e3dddf8e-2543x1300.png) Wenn Sie einen Alarm auf dem ersten Monitor öffnen, folgen die beiden anderen automatisch: - Der Video‑Viewer schaltet zu den Kameras dieses Alarms. - Die Karte hebt den Standort und das Gerät hervor, von dem der Alarm stammt. Sie erhalten Alarm, Video und Standort nebeneinander, ohne selbst etwas öffnen zu müssen, sodass Sie schneller entscheiden und reagieren können. ## **Integrations‑Merkmale‑Überblick** GCXONE verbindet sich mit der Ascento‑Cloud über seine REST APIs für Roboterdaten und -steuerung, RTSP für Live‑Video und eine Subskription für Alarme und Ereignisse. Alles, was der Roboter sendet, wird dann in GCXONE zusammen mit Ihren anderen Geräten verwaltet.