Axis Communications Familien-Integrationshandbuch

Einleitung

Dieses Handbuch beschreibt die End‑zu‑Ende‑Integration zwischen der NXGEN Monitoring Platform und der Axis Communications‑Familie von Geräten, einschließlich Axis Network Cameras (IP‑Kameras), Axis Network Audio Systems (Horn‑Lautsprecher), Axis I/O Relay Modules und Axis Camera Station Pro (ACS). Ziel dieser Integration ist es, eine einheitliche Überwachung, Ereignisaufnahme, Geräte‑Steuerung, Audio‑Aktionen und eine vereinfachte Konfiguration von Axis‑Geräten innerhalb des NXGEN‑Ökosystems zu ermöglichen.

Systemübersicht

Axis‑Geräte kommunizieren über eine Kombination aus branchenüblichen und Axis‑eigenen Protokollen:

NXGEN verarbeitet Axis‑Daten für:

• Live‑Video‑Streaming
• Ereignis‑/Alarm‑Benachrichtigungen
• I/O‑Statusänderungen
• Audio‑Durchsagen
• ACS‑gespeicherte Video‑Wiedergabe

Systemarchitektur

Axis‑Kameras, Audio‑Geräte, ACS Pro und I/O‑Module verbinden sich lokal mit dem Standort‑Router, der sicher über VPN (bevorzugt) oder ohne VPN mit der Cloud verknüpft ist. NXGEN empfängt alle Video‑Streams, Alarme und Geräte‑Telemetriedaten vom Cloud‑Endpunkt und stellt sie den Überwachungs‑Operatoren in verschiedenen Anwendungen bereit. Die Architektur ermöglicht:

1. Zentralisiertes Management
2. Einheitliche Ereignis‑Verarbeitung
3. Echtzeit‑Audio‑ und I/O‑Steuerungen
4. Skalierbare Multi‑Site‑Überwachung

Kommunikationsflüsse

Axis Communications Familienkonfiguration

Voraussetzungen für die Integration

Schritt 1:Axis‑Gerät auf die neueste Firmware aktualisieren

Schritt 2:HTTP aktivieren

Schritt 3:API‑Zugriffsbenutzer mit den erforderlichen Privilegien erstellen

Schritt 4: Für ACS Pro:

• "Web Client" aktivieren
• Ports 29202 (TCP), 29204 (API) und 29205 (Streaming) sind offen (je nach Version), 80 und 443.

Schritt 5: Stellen Sie die Netzwerkverbindung (entweder öffentlichen Netzwerkzugriff oder über VPN) zwischen dem Standortnetzwerk und der Überwachungsplattform (GCXONE) sicher.

Schritt 6: Für IP‑Kameras:

• VAPIX‑API aktivieren (standardmäßig aktiviert).
• API‑Port ist offen und erreichbar.
• Ereignisdienst aktivieren.
• RTSP‑Parameter bei Bedarf (Codec, Bitrate) konfigurieren, um Ihrer Netzwerkbandbreite zu entsprechen.

Axis Communications Familien‑Konfigurationshandbuch mit GCXONE

Nachfolgend finden Sie die Schritte zum Hinzufügen von Axis Camera Station (ACS) Pro, Axis I/O‑Modulen und Axis Network Horn Speakers in die GCXONE‑Umgebung.

Konfiguration der Axis‑Family‑Geräte

Schritt 1: Einloggen in die GCXONE‑Plattform

1. Öffnen Sie die (GCXONE Cloud Experience)-URL in einem Browser.
2. Einloggen mit Ihren Administrator‑ oder Integrator‑Anmeldedaten.
3. Nach erfolgreichem Einloggen initialisiert das System Ihre Sitzung und lädt die mit Ihrem Mandanten verbundene Umgebung.

Schritt 2: Organisation auswählen

Wenn Ihr Mandant mit mehreren Organisationen, wird GCXONE Sie auffordern, die zu verwaltende Organisation auszuwählen.

1. Wenn mehrere Organisationen vorhanden sind: Sie sehen einen Organisationsauswahlbildschirm. Wählen Sie die richtige Organisation, um fortzufahren.
2. Wenn nur eine Organisation existiert: Loggt GCXONE Sie automatisch in die Standardorganisation ein und lädt direkt das Dashboard.

Schritt 3: Zur Konfigurations‑App navigieren

1. Im linken Apps‑Panel finden Sie das Symbol für Konfiguration.
2. Klicken Sie auf Konfiguration um den Konfigurationsarbeitsbereich zu öffnen.
3. Das System lädt den einheitlichen Konfigurationsbildschirm, in dem alle Kundenprofile, Standorte und Geräte verwaltet werden.

Schritt 4: Verständnis der Konfigurationshierarchie

GCXONE folgt einer strikten, intuitiven Hierarchie, um klare Gerätezugehörigkeit zu gewährleisten und eine saubere Datenstruktur zu erhalten: Kunde → Standort → Gerät → Kameras/Sensoren.

Wie diese Hierarchie funktioniert

• Kunde: Stellt die oberste organisationale Einheit dar (z. B. ein Unternehmen, ein Unternehmen oder ein Kunde). Jeder Kunde enthält einen oder mehrere physische oder logische Standorte.
• Standort: Stellt einen physischen Standort oder Einsatzbereich dar (Büro, Lager, Turmstandort, Einzelhandelsgeschäft usw.). Am Standort eingesetzte Geräte werden dem Standort zugeordnet, um Klarheit und betriebliche Kontrolle zu gewährleisten.
• Gerät: Stellt die tatsächlichen Hardware‑Endpunkte dar, wie zum Beispiel:
• Axis IP‑Kameras
• ACS Pro‑Recorder
• Axis I/O‑Module
• Axis Horn‑Lautsprecher

Diese Hierarchie gewährleistet:

• Saubere Konfigurationsverwaltung
• Präzise Alarmweiterleitung
• Mandantenübergreifende Trennung
• Standortbezogene Berichterstellung und Sichtbarkeit
• Skalierbares Onboarding für größere Unternehmensflotten

Schritt 5: Kunden/Standort auswählen oder erstellen

Nach dem Öffnen der Konfiguration‑App:

1. Wählen Sie einen vorhandenen Kunden/Standort aus der Liste oder klicken Sie auf "Add New", um ein neues übergeordnetes Kunden‑ und Standort‑Profil zu erstellen.

Schritt 6: Geräte zum Standort hinzufügen

Nachdem der Standort erstellt und ausgewählt wurde:

1. Öffnen Sie den Geräte‑Tab unter dem Standort.

2. Klicken Sie auf Neu hinzufügen.

3. Wählen Sie den Typ des Axis‑Geräts, das Sie hinzufügen möchten:

• Axis Camera Station (für ACS Pro‑Geräte)
• Axis (für I/O‑Module und IP‑Kameras)
• Genesis Audio (für Axis‑Horn‑Lautsprecher)

4. Das System öffnet den Gerätekonfigurations‑Assistenten.

Schritt 7: Gerätedetails angeben

GCXONE fordert Sie auf, Folgendes einzugeben:

• Name
• IP-Adresse / Hostname
• Kontrol Port
• Benutzername & Passwort
• Geräte‑Zeitzone

Nach Eingabe klicken Sie Suche.

Schritt 8: Kameralisten‑Erkennung

GCXONE ruft automatisch ab:

• Kameraliste (für ACS Pro oder IP‑Kamera – falls mehrere Profile/Ansichten vorhanden sind)
• I/O‑Ports (für I/O‑Module)

• Klicken Sie auf Speichern und schließen Sie die Gerätehinzufügung ab.
• Die Geräteübersicht wird angezeigt, sobald das Speichern abgeschlossen ist.

• Ähnlich für Axis IO-Module können Sie den Gerätetyp als "Axis" auswählen und den Kontrol Port als Vapix‑API‑Port festlegen.

Damit werden alle verfügbaren Eingänge und Ausgänge abgerufen und zur Geräte‑I/O‑Liste hinzugefügt.

Für Axis Horn Speaker können Sie den Gerätetyp als "Genesis Audio" auswählen, einen gültigen Namen vergeben und auf Entdecken klicken.

Nachdem der Horn Speaker entdeckt und hinzugefügt wurde, erzeugt GCXONE automatisch den SIP‑Benutzernamen, das Passwort und die Domain‑Details. Diese Anmeldedaten müssen am Horn Speaker konfiguriert werden, damit er sich beim SIP‑Endpunkt registriert und die Audio‑Kommunikation aktiviert.

Stellen Sie sicher, dass die oben genannten SIP‑Details im Horn Speaker konfiguriert sind, indem Sie den generierten Benutzernamen, das Passwort und die Domain auf der SIP‑Einstellungsseite des Geräts eingeben und die Konfiguration speichern. Dadurch wird gewährleistet, dass der Speaker erfolgreich beim GCXONE‑SIP‑Endpunkt registriert wird und die Audio‑Kommunikation funktioniert.

Um zu überprüfen, ob die Kamera korrekt streamt, öffnen Sie eine beliebige Kamera aus der konfigurierten Geräteliste. Sie sollten den Live‑Video‑Stream ohne Unterbrechungen sehen können.

In der Anwendung Video Viewer können Sie weitere Video‑Operationen durchführen, z. B. Multi‑Kamera‑Streaming, PTZ‑Steuerung, Preset‑Verwaltung, Wiedergabe von aufgezeichnetem Material und mehr. Ziehen Sie das Gerät einfach per Drag‑and‑Drop in den Wiedergabebereich, und das System beginnt, den Live‑Multi‑Kamera‑Stream anzuzeigen.

Ereignisse‑ und Regeln‑Konfiguration

1. GCXONE unterstützt die Alarmweiterleitung von ACS pro über Action Rules. So konfigurieren Sie:

• Melden Sie sich beim ACS‑Client an.
• Navigieren Sie zum Abschnitt Ereignisse und öffnen Sie Action Rules.
• Klicken Sie auf New Action Rule, um den Konfigurationsassistenten zu starten.
• Wählen Sie den gewünschten Alarm‑Trigger, z. B.:

Bewegungserkennung

Geräte‑Ereignisse

Eingang/Ausgang‑Ereignis

• Nachdem Sie den Trigger ausgewählt haben, setzen Sie die Aktion auf "Send HTTP Notification".

• Fahren Sie mit dem Assistenten fort, um die Benachrichtigungsdetails zu definieren.

Konfigurieren Sie die folgenden Parameter in der HTTP‑Notification:

• Um den Anfragekörper zu konfigurieren, verwenden Sie die folgende JSON-Vorlage. Ersetzen Sie die Platzhalterwerte (<<DEVICE_ID_FROM_GENESIS>>, <<CAMERA_ID_FROM_GENESIS>>) mit der tatsächlichen Device ID und Camera ID, die Sie aus der GCXONE Configuration URL erhalten.

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. }

• Sie können die Platzhalterwerte direkt aus der Konfigurations‑URL beziehen.

• So können Sie die URL interpretieren, um die Platzhalterwerte für die Device ID und Camera ID zu extrahieren.

Testen und Verifizieren

1. Lösen Sie eine bekannte Regel in ACS Pro aus (z. B. Bewegung oder Analytik‑Warnung).
2. Vergewissern Sie sich in GCXONE, dass das entsprechende Ereignis in der Video‑Aktivitätssuche oder im Alarm‑Dashboard auf Geräteebene erscheint.
3. Falls keine Ereignisse angezeigt werden, prüfen Sie die Netzwerk‑Erreichbarkeit zu acsproxy.nxgen.cloud/eventIngest und überprüfen Sie, ob das Action Set aktiv ist.

Bewährte Verfahren

1. Testen Sie stets die Konnektivität mit acsproxy.nxgen.cloud/eventIngest vor dem Speichern.
2. Stellen Sie sicher, dass Firewall- oder ausgehende Netzwerkregeln TCP‑Verkehr zum GCXONE‑Endpunkt zulassen.
3. Verändern Sie nicht die Platzhalter‑Syntax – jedes falsche Zeichen führt zu einem Fehler beim JSON‑Parsing.

Alarmverarbeitungs‑Übersicht

GCXONE bietet einen mehr‑applikations‑basierten Alarm‑Ablauf, der für professionelle Überwachungszentren konzipiert ist. Wird ein Alarm von einem Axis‑Gerät empfangen, arbeiten drei zentrale Anwendungen zusammen, um dem Bediener vollständige Lage­bewusstheit und eine schnelle Reaktionsfähigkeit zu ermöglichen.

Workflow‑Anwendung (Alarmverarbeitung)

1. Die Workflow‑App (in der Regel die Talos‑Alarm‑Management‑Ansicht) dient als primäre Alarm‑Konsole des Bedieners.
2. Alarme werden mit allen Details angezeigt, einschließlich Gerät, Standort, Kunde, Zeitstempel, Auslösertyp und Schweregrad.
3. Bediener öffnen einen Alarm, um die Untersuchung zu beginnen, ihn zu bestätigen, Notizen hinzuzufügen, ihn zuzuweisen oder bei Bedarf zu eskalieren.
4. Diese Anwendung fungiert als zentrale Steuerstelle für die Verwaltung des gesamten Alarm‑Lebenszyklus.

Video‑Viewer‑Anwendung (Alarmbestätigung)

1. Wenn ein Alarm in der Workflow‑App geöffnet wird, schaltet der Video‑Viewer automatisch in den entsprechenden Alarm‑Kontext. Er zeigt an:

• Bild vor dem Alarm
• Bild des aktuellen Alarms
• Bild nach dem Alarm.

2. Bediener haben außerdem Zugriff auf ein vollständiges Set an Videowerkzeugen:

• Live‑Video
• Wiedergabe‑Zeitleiste
• PTZ‑Steuerung
• Voreinstellungs‑Navigation
• Audio‑Durchsage/Talk‑down
• Mehrkamera‑Layouts

3. Dadurch erhalten Bediener eine sofortige visuelle Bestätigung und können das Ereignis in Echtzeit verifizieren.

Karten‑Ansicht (Geospatiale Übersicht & Ausgangs‑Steuerung)

1. Die Karten‑Anwendung zeigt alle Geräte und Ausgänge auf einer interaktiven Standort‑Karte an.

2. Wenn ein Alarm in der Workflow‑App ausgewählt wird, zentriert die Karten‑Ansicht automatisch auf den Alarm‑Standort.

3. Bediener können mit Geräten auf der Karte interagieren und Ausgänge auslösen, zum Beispiel:

• Sirenen
• Stroboskope
• I/O‑Relais
• Aufnahme‑Audioclip‑Auslösung über Horn‑Lautsprecher.

4. Dadurch erhalten Bediener schnellen Zugriff auf Reaktions‑Aktionen direkt im Standort‑Layout.

Mehrmonitor‑Bediener‑Ablauf

In professionellen Leitstand-Umgebungen verwenden Bediener typischerweise drei oder mehr Monitore. GCXONE ist für diese Umgebung ausgelegt:

Monitor 1: Workflow-Anwendung

Monitor 2: Video Viewer

Monitor 3: Karten‑Ansicht

Wenn der Bediener einen Alarm in der Workflow-Anwendung öffnet:

1. Der Video Viewer auf seinem dedizierten Monitor schaltet automatisch auf die Videoquelle(n) des Alarms um.
2. Die Karten‑Ansicht aktualisiert sich gleichzeitig, um den Standort und das Gerät des Alarms hervorzuheben.

Dieses synchronisierte Kontext‑Wechseln stellt sicher, dass:

1. Der Bediener hat eine ganzheitliche 360°‑Ansicht des Alarms.
2. Alle relevanten Werkzeuge (Video, PTZ, Audio, Karten, Ausgaben) sind sofort verfügbar.
3. Die Reaktionszeit wird minimiert und das Situationsverständnis maximiert.

Integrations‑Merkmale Überblick

Die GCXONE‑Plattform integriert sich über eine Kombination aus RESTful‑APIs, RTSP‑Streaming und webhook‑basiertem Ereignis‑Forwarding mit Axis Camera Station Pro. Diese Integration ermöglicht ein einheitliches Management, die Überwachung und Analytik aller angeschlossenen Kameras.

Zusammenfassung

Durch Befolgen dieses Leitfadens können Sie Axis Camera Station Pro und das gesamte Axis‑Ökosystem in Ihre NXGEN‑Überwachungsplattform integrieren. Diese Integration vereinheitlicht:

• Live‑ und aufgezeichnetes Video
• Alarmaufnahme
• Audioansagen
• E/A‑Steuerung
• Arbeitsabläufe für mehrere Anwendungen von Bedienern

Ergebnis: umfassende, skalierbare und effiziente Überwachungsarbeiten.