Handleiding voor de integratie van de Axis Communications-productfamilie

Inleiding

In deze handleiding wordt de volledige integratie beschreven tussen het NXGEN Monitoring Platform en de reeks apparaten van Axis Communications, waaronder Axis-netwerkcamera’s (IP-camera’s), Axis-netwerkaudiosystemen (hoornluidsprekers), Axis I/O-relaismodules en Axis Camera Station Pro (ACS). Het doel van deze integratie is om vanuit het NXGEN-ecosysteem één centraal punt te bieden voor monitoring, het vastleggen van gebeurtenissen, apparaatbesturing, audioacties en een vereenvoudigde configuratie van Axis-apparaten.

Systeemoverzicht

Axis-apparaten communiceren via een combinatie van protocollen die aan de industriestandaard voldoen en protocollen die eigen zijn aan Axis:

NXGEN gebruikt gegevens van Axis voor:

• Live videostreaming
• Meldingen over gebeurtenissen/alarmen
• Veranderingen in de I/O-status
• Geluidsmededelingen
• Afspelen van opgeslagen video's via ACS

Systeemarchitectuur

Axis-camera’s, audioapparatuur, ACS Pro en I/O-modules worden lokaal aangesloten op de router ter plaatse, die via een VPN (bij voorkeur) of zonder VPN een beveiligde verbinding met de cloud tot stand brengt. NXGEN ontvangt alle videostreams, alarmen en apparaatgegevens van het cloud-eindpunt en presenteert deze aan de bewakingsmedewerkers via verschillende applicaties. Deze architectuur maakt het volgende mogelijk:

1. Gecentraliseerd beheer
2. Gecentraliseerde afhandeling van gebeurtenissen
3. Realtime audio- en I/O-bediening
4. Schaalbare monitoring van meerdere locaties

Communicatiestromen

Configuratie van de Axis Communications-productfamilie

Vereisten vóór de integratie

1. Het Axis-apparaat is bijgewerkt naar de nieuwste firmware.
2. HTTP is ingeschakeld.
3. Een gebruiker met de nodige rechten voor API-toegang.
4. Voor ACS Pro:

• "Webclient" ingeschakeld
• De poorten 29202 (TCP), 29204 (API) en 29205 (streaming) zijn open (afhankelijk van de versie), evenals 80 en 443.

5. Zorg voor een netwerkverbinding (via een openbaar netwerk of via een VPN) tussen het netwerk van de locatie en het monitoringplatform (GCX-ONE).

6. Voor IP-camera's:

• Schakel de VAPIX-API in (standaard ingeschakeld).
• De API-poort is open en toegankelijk.
• Schakel de gebeurtenisservice in.
• Stel indien nodig de RTSP-parameters (codec, bitsnelheid) in, zodat deze aansluiten bij de bandbreedte van uw netwerk.

Configuratiehandleiding voor de Axis Communications-productfamilie met GCX-ONE

Hieronder vindt u de stappen om Axis Camera Station (ACS) Pro, Axis I/O-modules en Axis netwerkhoornluidsprekers toe te voegen aan de GCX-ONE-omgeving.

Configuratie van apparaten uit de Axis Family  

Stap 1: Inloggen op het GCX-ONE-platform

1. Open de URL (GCX-ONE Cloud Experience) in een browser.
2. Meld u aan met uw beheerders- of integratorgegevens.
3. Nadat u zich succesvol hebt aangemeld, start het systeem uw sessie op en laadt het de omgeving die bij uw tenant hoort.

Stap 2: Kies uw organisatie

Als uw tenant is geconfigureerd met verschillende organisaties, GCX-ONE vraagt je vervolgens om de organisatie te selecteren die je wilt beheren.

1. Als er meerdere organisaties zijn: er verschijnt een scherm waarin u een organisatie kunt selecteren. Kies de juiste organisatie om verder te gaan.
2. Als er slechts één organisatie bestaat: GCX-ONE logt je automatisch in bij de standaardorganisatie en laadt direct het dashboard.

Stap 3: Ga naar de configuratie-app

1. Zoek in het app-paneel aan de linkerkant het pictogram ‘Configuratie’.
2. Klik Configuratie om de configuratiewerkruimte te openen.
3. Het systeem opent het centrale configuratiescherm, waar alle klantprofielen, locaties en apparaten worden beheerd.

Stap 4: Inzicht in de configuratiehiërarchie

GCX-ONE hanteert een strikte, intuïtieve hiërarchie om duidelijkheid te scheppen over het eigendom van apparaten en een overzichtelijke gegevensstructuur te behouden: Klant → Locatie → Apparaat → Camera’s/Sensoren.

Hoe deze hiërarchie werkt

• Klant: Verwijst naar de organisatie-eenheid op het hoogste niveau (bijvoorbeeld een bedrijf, onderneming of klant). Elke klant omvat één of meer fysieke of logische locaties.
• Website: Verwijst naar een fysieke locatie of een inzetgebied (kantoor, magazijn, zendmast, winkel, enz.). Apparaten die op die locatie worden ingezet, worden aan de locatie gekoppeld met het oog op duidelijkheid en operationele controle.
• Apparaat: Verwijst naar de daadwerkelijke hardware-eindpunten, zoals:
• Axis IP-camera's
• ACS Pro-recorders
• Axis I/O-modules
• Axis-hoornluidsprekers

Deze hiërarchie zorgt ervoor dat:

• Overzichtelijk configuratiebeheer
• Nauwkeurige alarmdoorgifte
• Scheiding tussen verschillende huurders
• Rapportage en inzicht per locatie
• Schaalbare onboarding voor grotere bedrijfswagenparken

Stap 5: Selecteer of maak een klant/locatie aan

Zodra je in de app ‘Configuratie’ bent:

1. Kies een bestaande klant/vestiging uit de lijst, of klik op ‘Nieuw toevoegen’ om een nieuw klant- en vestigingsprofiel op het hoogste niveau aan te maken.

Stap 6: Apparaten aan de site toevoegen

Zodra de site is aangemaakt en geselecteerd:

1. Open het tabblad ‘Apparaten’ onder de site.
2. Klik op 'Nieuw toevoegen'.
3. Kies het type Axis-apparaat dat u wilt toevoegen:

• Axis Camera Station (voor ACS Pro-apparaten)
• Axis (voor I/O-modules en IP-camera's)
• GCX-ONE Audio (voor Axis-hoornluidsprekers)

4. Het systeem opent de configuratiewizard voor het apparaat.

Stap 7: Geef de apparaatgegevens op

GCX zal vragen om:

• Naam
• IP-adres / Hostnaam
• Besturingspoort
• Gebruikersnaam en wachtwoord
• Tijdzone van het apparaat

Zodra je dit hebt ingevoerd, klik je op Ontdek.

Stap 8: Overzicht van beschikbare camera’s

GCX-ONE haalt automatisch het volgende op:

• Cameralijst (voor ACS Pro of IP-camera – indien deze meerdere profielen/weergaven heeft)
• I/O-poorten (voor I/O-modules)

• Klik op ‘Opslaan’ en rond het toevoegen van het apparaat af.
• Zodra het opslaan is voltooid, wordt het apparaatoverzicht weergegeven.

• Hetzelfde geldt voor Axis IO-modules: je kunt bij ‘Device Type’ de optie ‘Axis’ selecteren en als besturingspoort de Vapix API-poort kiezen.

Hiermee worden alle beschikbare in- en uitgangen opgehaald en aan de I/O-lijst van het apparaat toegevoegd.

Voor de Axis-hoornluidspreker kun je als apparaattype "GCX-ONE Audio" selecteren, een geldige naam invoeren en op 'Detecteren' klikken.

Nadat de hoornluidspreker is gedetecteerd en toegevoegd, genereert GCX-ONE automatisch de SIP-gebruikersnaam, het wachtwoord en de domeingegevens. Deze inloggegevens moeten op de hoornluidspreker worden geconfigureerd, zodat deze zich bij het SIP-eindpunt kan registreren en audiocommunicatie mogelijk wordt.

Zorg ervoor dat de bovenstaande SIP-gegevens in de hoornluidspreker zijn geconfigureerd door de gegenereerde gebruikersnaam, het wachtwoord en het domein in te voeren op de SIP-instellingenpagina van het apparaat en de configuratie op te slaan. Zo zorg je ervoor dat de luidspreker zich succesvol registreert bij het GCX-ONE SIP-eindpunt voor audiocommunicatie.

Om te controleren of de camera correct streamt, opent u een willekeurige camera uit de lijst met geconfigureerde apparaten. U zou de live videostream zonder onderbrekingen moeten kunnen bekijken.

In de Video Viewer-applicatie kunt u aanvullende videofuncties uitvoeren, zoals streaming via meerdere camera’s, PTZ-besturing, beheer van voorinstellingen, het afspelen van opgenomen beelden en nog veel meer. Sleep het apparaat gewoon naar het afspeelgebied en het systeem begint met het weergeven van de live stream van meerdere camera’s.

Configuratie van evenementen en regels

1. GCX-ONE ondersteunt het doorsturen van alarmen vanuit ACS pro via Action Rules. Om dit in te stellen:

• Log in op de ACS-client.
• Ga naar het gedeelte ‘Evenementen’ en open ‘Actieregels’.
• Klik op ‘Nieuwe actieregel’ om de configuratiewizard te starten.
• Kies de gewenste alarmtrigger, bijvoorbeeld:

Bewegingsdetectie

Apparaatgebeurtenissen

Invoer-/uitvoergebeurtenis

• Nadat je de trigger hebt geselecteerd, stel je de actie in op „HTTP-melding verzenden”.

• Volg de stappen van de wizard om de details van de melding in te stellen.

Stel de volgende parameters in de HTTP-melding in:

• Gebruik het volgende JSON-sjabloon om de Request Body te configureren. Vervang de waarden in de plaatshouders (<<device_id_from_genesis>>, <<camera_id_from_genesis>></camera_id_from_genesis></device_id_from_genesis>) met de daadwerkelijke apparaat-ID en camera-ID, die u kunt vinden via de GCX-ONE-configuratie-URL.

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

• Je kunt de waarden van de plaatshouders rechtstreeks uit de configuratie-URL halen.

• Hieronder wordt uitgelegd hoe je de URL kunt interpreteren om de waarden van de plaatshouders voor het apparaat-ID en het camera-ID te achterhalen.

Testen en verificatie

1. Activeer een bekende regel in ACS Pro (bijvoorbeeld een bewegings- of analysewaarschuwing).
2. Controleer in GCX-ONE of de betreffende gebeurtenis wordt weergegeven in de zoekresultaten voor videoactiviteit of op het alarmdashboard op apparaatniveau.
3. Als er geen gebeurtenissen worden weergegeven, controleer dan of er verbinding is met acsproxy.nxgen.cloud/eventIngest en controleer of de actieset actief is.

Beste praktijken

1. Controleer altijd de verbinding met acsproxy.nxgen.cloud/eventIngest voordat je opslaat.
2. Zorg ervoor dat het firewallbeleid of het beleid voor uitgaand netwerkverkeer TCP-verkeer naar het GCX-ONE-eindpunt toestaat.
3. Pas de syntaxis van de plaatshouders niet aan — elk onjuist teken zorgt ervoor dat het parseren van JSON mislukt.

Overzicht van de alarmverwerking

GCX-ONE biedt een workflow voor alarmafhandeling die geschikt is voor meerdere toepassingen en speciaal is ontworpen voor professionele meldkamers. Wanneer er een alarm wordt ontvangen van een Axis-apparaat, werken drie belangrijke applicaties samen om operators een volledig beeld van de situatie te geven en hen in staat te stellen snel te reageren.

1. Workflow-applicatie (alarmafhandeling)

1. De Workflow-app (meestal het Talos-alarmbeheer) fungeert als de belangrijkste alarmconsole van de operator.
2. Alarmen worden weergegeven met alle details, waaronder het apparaat, de locatie, de klant, tijdstempels, het type trigger en de ernstgraad.
3. Operators openen een alarm om het onderzoek te starten, het te bevestigen, aantekeningen toe te voegen, het toe te wijzen of het indien nodig te escaleren.
4. Deze applicatie fungeert als centraal controlepunt voor het beheer van de volledige levenscyclus van alarmen.

2. Videoweergave-app (controle van alarmen)

1. Wanneer een alarm wordt geopend in de Workflow-app, schakelt de Video Viewer automatisch over naar de bijbehorende alarmcontext. Er wordt het volgende weergegeven:

• Afbeelding vóór het alarm
• Afbeelding van het stroomalarm
• Afbeelding na het alarm.

2. Exploitanten hebben ook toegang tot een volledig pakket aan videotools:

• Livevideo
• Afspeeltijdlijn
• PTZ-besturing
• Vooraf ingestelde navigatie
• Geluidsmelding/Talk-down
• Opstellingen met meerdere camera’s

3. Hierdoor krijgen operators direct visuele bevestiging en kunnen ze de gebeurtenis in realtime controleren.

3. Kaartweergave (geospatiaal inzicht en uitvoerbeheer)

1. De Map-applicatie geeft alle apparaten en uitgangen weer op een interactieve plattegrond.
2. Wanneer er in de Workflow-app een alarm wordt geselecteerd, wordt de kaartweergave automatisch gecentreerd op de locatie van het alarm.
3. Operators kunnen interactie aangaan met apparaten op de kaart en uitgangen activeren, zoals:

• Sirenes
• Stroboscooplampen
• I/O-relais
• Het afspelen van een audiofragment via de hoornluidspreker.

4. Hierdoor krijgen operators direct op de plattegrond van de locatie snel toegang tot de te nemen maatregelen.

Werkstroom voor operators met meerdere beeldschermen

In professionele regiekamers maken operators doorgaans gebruik van drie of meer beeldschermen. De GCX-ONE is ontworpen om deze omgeving te ondersteunen:

Monitor 1: Workflow-applicatie

1. Monitor 2: Videospeler

1. Monitor 3: Kaartweergave

Wanneer de gebruiker een alarm opent in de Workflow-applicatie:

1. De videoweergave op de daarvoor bestemde monitor schakelt automatisch over naar de videobron(nen) van het alarm.
2. De kaartweergave wordt tegelijkertijd bijgewerkt om de locatie van het alarm en het apparaat te markeren.

Deze gesynchroniseerde contextwisseling zorgt ervoor dat:

1. De operator heeft een totaaloverzicht van het alarm, van alle kanten.
2. Alle relevante functies (video, PTZ, audio, kaarten, uitgangen) zijn direct beschikbaar.
3. De reactietijd wordt tot een minimum beperkt en het inzicht in de situatie wordt gemaximaliseerd.

Overzicht van integratiefuncties

Het GCX-ONE-platform kan worden geïntegreerd met Axis Camera Station Pro via een combinatie van RESTful API’s, RTSP-streaming en het doorsturen van gebeurtenissen via webhooks. Deze integratie maakt een uniform beheer, monitoring en analyse van alle aangesloten camera’s mogelijk.

Samenvatting

Door deze handleiding te volgen, kunt u Axis Camera Station Pro en het volledige Axis-ecosysteem integreren in uw NXGEN-bewakingsplatform. Deze integratie brengt het volgende samen:

• Live- en opgenomen video
• Alarmverwerking
• Geluidsmededelingen
• I/O-besturing
• Workflows voor operators met meerdere toepassingen

Dit leidt tot uitgebreide, schaalbare en efficiënte monitoringactiviteiten.