Axis Communications Familie Integratiehandleiding

Inleiding

Deze gids beschrijft de end-to-end integratie tussen het NXGEN Monitoring Platform en de Axis Communications-familie van apparaten, inclusief Axis Network Cameras (IP Cameras), Axis Network Audio Systems (Horn Speakers), Axis I/O Relay Modules en Axis Camera Station Pro (ACS). Het doel van deze integratie is het mogelijk maken van geïntegreerd monitoren, eventinname, apparaatbesturing, audio‑acties en vereenvoudigde Configuratie van Axis-apparaten vanuit het NXGEN-ecosysteem.

Systeem Overzicht

Axis-apparaten communiceren via een combinatie van industriestandaard- en Axis‑native protocollen:

NXGEN verbruikt Axis-gegevens voor:

• Live video streaming
• Event/alarm notificaties
• I/O statuswijzigingen
• Audio aankondigingen
• ACS opgeslagen video Afspelen

Systeem Architectuur

Axis-camera's, audio‑apparaten, ACS Pro en I/O‑Modules verbinden lokaal met de site‑router, die veilig koppelt met de cloud via VPN (voorkeur) of zonder VPN. NXGEN ontvangt alle video‑streams, Alarmen en apparaat‑telemetrie van het cloud‑endpoint en presenteert deze aan monitoren‑operatoren in verschillende toepassingen. De architectuur maakt mogelijk:

1. Gecentraliseerd beheer
2. Geïntegreerde eventafhandeling
3. Realtime audio- en I/O‑besturingen
4. Schaalbare multi‑site monitoren

Communicatie Stromen

Axis Communications Familie Configuratie

Pre-Integratie Vereisten

Stap 1: Axis apparaat bijgewerkt naar de nieuwste firmware.

Stap 2: HTTP Ingeschakeld.

Stap 3: API toegang gebruiker met benodigde permissies.

Stap 4: Voor ACS Pro:

• "Web Client" Ingeschakeld
• Poorten 29202 (TCP), 29204 (API) en 29205 (streaming) zijn open (afhankelijk van versie), 80 en 443.

Stap 5: Zorg voor netwerkconnectiviteit (ofwel openbare netwerkaansluiting of via VPN) tussen het Site netwerk en het monitoring platform (GCXONE).

Stap 6: Voor IP Camera's:

• VAPIX API inschakelen (standaard ingeschakeld).
• API Poort is open en toegankelijk.
• Event Service inschakelen.
• Configureer RTSP parameters indien nodig (codec, bitrate) om uw netwerkbandbreedte te matchen.

Axis Communications Familie Config Gids met GCXONE

Zie hieronder de stappen om Axis Camera Station (ACS) Pro, Axis I/O-modules en Axis Network Horn Speakers toe te voegen aan de GCXONE-omgeving.

Configuratie van Axis-familieapparaten

Stap 1: Inloggen op het GCXONE-platform

1. Open de (GCXONE Cloud Experience)-URL in een browser.
2. Log in met uw beheerder- of integratorreferenties.
3. Na een succesvolle login initialiseert het systeem uw sessie en laadt de omgeving die aan uw tenant is gekoppeld.

Stap 2: Selecteer uw organisatie

Als uw tenant is geconfigureerd met meerdere organisaties, zal GCXONE u vragen de organisatie te selecteren die u wilt beheren.

1. Als er meerdere organisaties bestaan: u ziet een organisatieselectiescherm. Kies de juiste organisatie om door te gaan.
2. Als er slechts één organisatie bestaat: logt GCXONE u automatisch in op de standaardorganisatie en laadt direct het dashboard.

Stap 3: Navigeer naar de Configuratie‑app

1. Zoek in het linkerpaneel Apps het Configuratie‑pictogram.
2. Klik op Configuratie om de configuratiewerkruimte te openen.
3. Het systeem laadt het geïntegreerde configuratiescherm, waar alle klantprofielen, sites en apparaten worden beheerd.

Stap 4: Begrijpen van de configuratiehiërarchie

GCXONE hanteert een strikte, intuïtieve hiërarchie om duidelijke apparaattoewijzing te waarborgen en een schone datastructuur te behouden: Klant → Site → Apparaat → Camera's/Sensoren.

Hoe deze hiërarchie werkt

• Klant: Vertegenwoordigt de bovenliggende organisatorische entiteit (bijv. een bedrijf, onderneming of cliënt). Elke klant bevat één of meer fysieke of logische sites.
• Site: Vertegenwoordigt een fysieke locatie of inzetgebied (kantoor, magazijn, torenlocatie, winkel, enz.). Apparaten die op die locatie zijn geïnstalleerd, worden aan de site gekoppeld voor duidelijkheid en operationele controle.
• Apparaat: Vertegenwoordigt de daadwerkelijke hardware‑eindpunten, zoals:
• Axis IP-camera's
• ACS Pro-recorders
• Axis I/O-modules
• Axis Horn Speakers

Deze hiërarchie zorgt voor:

• Schone configuratie‑beheer
• Nauwkeurige alarmroutering
• Multi-tenant scheiding
• Site-gewijze rapportage en zichtbaarheid
• Schaalbare onboarding voor grotere Onderneming-vloten

Stap 5: Selecteer of maak een Klant/Site

Eenmaal in de Configuratie‑app:

1. Kies een bestaande Klant/Site uit de lijst, of klik Voeg nieuw toe om een nieuw top‑level klant‑ en site‑profiel aan te maken.

Stap 6: Voeg Apparaten toe aan de Site

Nadat de site is aangemaakt en geselecteerd:

1. Open het Apparaten‑tabblad onder de site.

2. Klik Voeg nieuw toe.

3. Kies het type Axis‑apparaat dat u wilt toevoegen:

• Axis Camera Station (for ACS Pro devices)
• Axis (for I/O Modules and IP Cameras)
• Genesis Audio (for Axis Horn Speakers)

4. Het systeem opent de apparaat‑configuratiewizard.

Stap 7: Verstrek Apparaat‑details

GCXONE vraagt om:

• Naam
• IP-adres / hostnaam
• Controlepoort
• Gebruikersnaam & wachtwoord
• Apparaat‑tijdzone

Na invoer, klik Ontdekken.

Stap 8: Camera‑lijst ontdekking

GCXONE haalt automatisch op:

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

• Klik op Opslaan en voltooi de toevoeging van het apparaat.
• Apparaatoverzicht wordt weergegeven zodra het opslaan voltooid is.

• Evenzo voor Axis IO-modules kunt u Apparaattype selecteren als "Axis" en poort als de Vapix API‑poort.

Dit haalt alle beschikbare ingangen en uitgangen op en voegt ze toe aan de Apparaat‑I/O‑lijst.

Voor Axis Horn Speaker kunt u Apparaattype selecteren als "Genesis Audio", een geldige naam opgeven en op Ontdekken klikken.

Nadat de hoornspeaker is ontdekt en toegevoegd, genereert GCXONE automatisch de SIP‑gebruikersnaam, het wachtwoord en de domeindetails. Deze inloggegevens moeten op de hoornspeaker worden geconfigureerd zodat deze zich registreert bij het SIP‑eindpunt en audio‑communicatie inschakelt.

Zorg ervoor dat de bovenstaande SIP‑details in de hoornspeaker 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. Hierdoor registreert de speaker zich succesvol bij het GCXONE SIP‑eindpunt voor audio‑communicatie.

Om te verifiëren dat de camera correct streamt, opent u een willekeurige camera uit de geconfigureerde apparaatlijst. U moet de live‑videostream zonder onderbrekingen kunnen bekijken.

In de Video‑applicatie kunt u extra video‑bewerkingen uitvoeren, zoals multi‑camera‑streaming, PTZ‑bediening, preset‑beheer, afspelen van opgenomen beelden en meer. Sleep simpelweg het apparaat naar het afspeelgebied, en het Systeem begint de live multi‑camera‑stream weer te geven.

Evenementen‑ en Regelsconfiguratie

1. GCXONE ondersteunt alarm‑doorsturing vanuit ACS pro via Actieregels. Om dit te configureren:

• Log in op de ACS‑client.
• Navigeer naar de sectie Evenementen en open Actieregels.
• Klik op Nieuwe Actieregel om de configuratiewizard te starten.
• Kies de gewenste alarmtrigger, bijvoorbeeld:

Bewegingsdetectie

Apparaat‑gebeurtenissen

Ingang/Uitgang‑gebeurtenis

• Na het selecteren van de trigger stelt u de Actie in op "Send HTTP Notification".

• Ga verder met de wizard om de notificatiedetails te definiëren.

Configureer de volgende parameters in de HTTP‑notificatie:

• Om de Request Body te configureren, gebruikt u de volgende JSON-sjabloon. Vervang de placeholder-waarden (<<DEVICE_ID_FROM_GENESIS>>, <<CAMERA_ID_FROM_GENESIS>>) met de daadwerkelijke Device ID en Camera ID, die u kunt verkrijgen via de GCXONE Configuration URL.

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

• U kunt de placeholder-waarden rechtstreeks van de configuratie‑URL verkrijgen.

• Hier ziet u hoe u de URL kunt interpreteren om de placeholder‑waarden voor de Device ID en Camera ID te extraheren.

Testen en verificatie

1. Activeer een bekende regel in ACS Pro (bijv. beweging of analyse‑alarm).
2. Controleer in GCXONE of het overeenkomstige event verschijnt in Video Events of op het alarmdashboard op apparaatsniveau.
3. Als er geen events verschijnen, controleer dan de netwerkbereikbaarheid naar acsproxy.nxgen.cloud/eventIngest en verifieer dat de Action Set actief is.

Best practices

1. Test altijd de connectiviteit met acsproxy.nxgen.cloud/eventIngest vóór het opslaan.
2. Zorg ervoor dat firewall- of uitgaande netwerkbeleid TCP‑verkeer naar het GCXONE‑eindpunt toestaat.
3. Vermijd het wijzigen van placeholder‑syntaxis — elk onjuist teken zal JSON‑parsing breken.

Overzicht Alarmverwerking

GCXONE biedt een workflow voor alarmafhandeling met meerdere applicaties, ontworpen voor professionele monitoringscentra. Wanneer een alarm wordt ontvangen van een Axis‑Apparaat, werken drie belangrijke applicaties samen om operators volledige situationele bewustzijn en snelle reactiemogelijkheid te geven.

Workflow‑applicatie (Alarmafhandeling)

1. De Workflow‑app (meestal de Talos‑alarmbeheerview) fungeert als de primaire alarmconsole van de operator.
2. Alarmen worden weergegeven met volledige details, inclusief Apparaat, Plaats, Klant, tijdstempels, trigger‑type en ernst.
3. Operators openen een alarm om onderzoek te starten, erkennen het, voegen notities toe, wijzen het toe, of schalen het op indien nodig.
4. Deze applicatie dient als centraal controlepunt voor het beheren van de volledige alarmlevenscyclus.

Video Viewer Application (Alarmverificatie)

1.Wanneer een alarm wordt geopend in de Workflow‑app, schakelt de Video Viewer automatisch over naar de bijbehorende alarmcontext. Het toont:

• Pre‑alarm afbeelding
• Huidige‑alarm afbeelding
• Post‑alarm afbeelding.

2.Bedieners hebben ook toegang tot een volledige reeks video‑tools:

• Live‑video
• Afspelen‑tijdlijn
• PTZ‑bediening
• Preset‑navigatie
• Audio‑aankondiging/Talk‑down
• Multi‑camera‑lay-outs

3.Dit geeft operatoren onmiddellijke visuele bevestiging en de mogelijkheid om het evenement in realtime te verifiëren.

Plattegrond‑view (Geospatiale bewustzijn & output‑besturing)

1. De Plattegrond‑applicatie toont alle apparaten en outputs gepositioneerd op een interactieve site‑plattegrond.

2. Wanneer een alarm wordt geselecteerd in de Workflow‑app, centreert de Plattegrond‑view automatisch op de alarmlocatie.

3.Operatoren kunnen interactie hebben met apparaten op de plattegrond en outputs activeren zoals:

• Sirenen
• Stroboscopen
• I/O‑relais
• Recorder‑audio‑clip activeren via Hoorn‑speaker.

4. Dit geeft operators snelle toegang tot responsacties direct op de site‑lay-out.

Multi‑monitor‑operator‑workflow

In professionele controlekamerinstallaties gebruiken operators doorgaans drie of meer monitoren. GCXONE is ontworpen om deze omgeving te ondersteunen:

Monitor 1: Workflow‑applicatie

Monitor 2: Video Viewer

Monitor 3: Plattegrond

Wanneer de operator een alarm opent in de Workflow‑applicatie:

1. De Video Viewer op het toegewezen monitor schakelt automatisch over naar de videobron(nen) van het alarm.
2. De Plattegrond wordt gelijktijdig bijgewerkt om de locatie van de site en het apparaat van het alarm te markeren.

Deze gesynchroniseerde context‑overgang zorgt ervoor dat:

1. De operator beschikt over een holistisch, 360°‑beeld van het alarm.
2. Alle relevante hulpmiddelen (video, PTZ, audio, kaarten, uitgangen) zijn direct beschikbaar.
3. De responstijd wordt geminimaliseerd en het situationele inzicht gemaximaliseerd.

Integratie Functies Overzicht

Het GCXONE‑platform integreert met Axis Camera Station Pro via een combinatie van RESTful‑API’s, RTSP‑streaming en webhook‑gebaseerde gebeurtenis‑doorsturing. Deze integratie maakt uniform beheer, monitoren en analyse mogelijk voor alle aangesloten camera’s.

Samenvatting

Door deze gids te volgen, kunt u Axis Camera Station Pro en het volledige Axis‑ecosysteem integreren in uw NXGEN monitoringsplatform. Deze integratie verenigt:

• Live‑ en opgenomen video
• Alarminname
• Audio‑aankondigingen
• I/O‑besturing
• Werkstromen voor meerdere applicaties voor operatoren

Resulterend in uitgebreide, schaalbare en efficiënte monitoringsoperaties.