GCXONEDocumentation

Cathexis VMS

Sur cette page
  1. Introduction
  2. Configuration Cathexis
  3. Guide de configuration Cathexis avec GCXONE

Introduction

L'intégration GCXONE–Cathexis connecte l'environnement de gestion vidéo Cathexis au GCXONE, permettant aux vidéos et aux informations d'événements d'une installation Cathexis d'être disponibles dans le flux de travail de surveillance GCXONE.

CathexisVision agit en tant que couche de gestion vidéo, gérant les Caméras connectées, la vidéo en direct et enregistrée, les appareils intégrés, les Alarmes et les fonctions de Caméra prises en charge telles que PTZ. Cathexis fournit également un cadre d'intégration pour connecter des systèmes et appareils externes via sa base de données d'intégration et son API.

Grâce à cette intégration, GCXONE communique avec le serveur Cathexis configuré et récupère les informations de Caméra et d'événement requises. Les flux de Caméra peuvent être accessibles via les interfaces Cathexis, tandis que les informations d'appareil et d'événement peuvent être utilisées par GCXONE pour la surveillance et la gestion des alarmes.

Portée de l'intégration

L'intégration GCXONE–Cathexis vise à apporter les capacités vidéo et d'événement requises d'un système CathexisVision au GCXONE.

Pour un système Cathexis configuré, GCXONE peut prendre en charge les domaines d'intégration suivants :

  • Découverte et identification des Caméras — Récupérer les Caméras disponibles et utiliser leurs identifiants de Caméra Cathexis pour les opérations ultérieures.
  • Vidéo en direct — Accéder au Direct de la Caméra via l'interface vidéo Cathexis.
  • Vidéo enregistrée — Accéder aux séquences enregistrées associées à une Caméra lorsqu'elles sont nécessaires à l'enquête d'un événement.
  • Images de référence — Récupérer une image de référence de Caméra pour l'identification ou la présentation d'un événement.
  • Contrôle PTZ — Contrôler les Caméras PTZ prises en charge et exécuter les opérations PTZ supportées, y compris les fonctions liées aux préréglages.
  • Événements d'appareil et de Caméra — Recevoir les informations d'événement Cathexis et d'Alarme technique, incluant les détails de la Caméra associée lorsqu'ils sont fournis.
  • Vidéo associée à l'événement — Utiliser les informations de Caméra et de piste de révision (vidéo enregistrée) incluses avec une alarme pour identifier la vidéo pertinente associée à un événement.
  • Intégration avec les appareils et objets Cathexis — Cathexis utilise son cadre d'intégration pour associer les appareils intégrés et leurs objets aux Caméras et aux événements.

Architecture du Système

Diagramme d'architecture montrant les Caméras et les appareils intégrés alimentant CathexisVision, qui se connecte via HTTP/HTTPS sur le port 33104 à la couche d'intégration GCXONE et aux opérateurs de la couche de surveillance.

Couche de terrain – Caméras et appareils vidéo

Il s'agit de la couche physique où les données vidéo et les données d'appareil associées prennent naissance.

Elle peut inclure :

  • Caméras IP
  • Unités vidéo / encodeurs
  • Appareils d'E/S
  • Caméras avec analytique ou capacités d'événement prises en charge

CathexisVision gère ces appareils et fournit l'accès à leur vidéo, statut et fonctions prises en charge. Selon les capacités de la Caméra, Cathexis peut fournir des flux en direct, des vidéos enregistrées, des fonctions PTZ et des événements de Caméra.

Couche plateforme Cathexis – CathexisVision

Le serveur CathexisVision agit en tant que couche de gestion vidéo entre les appareils physiques et le GCXONE.

Il est responsable de :

  • Gestion des Caméras connectées et des ressources vidéo
  • Enregistrement et mise à disposition des vidéos stockées
  • Gestion de la disponibilité et de la configuration des caméras
  • Traitement des événements et alarmes pris en charge
  • Fourniture des ressources des caméras, flux en direct et pistes de révision
  • Fourniture des fonctions PTZ et E/S prises en charge

L’API Cathexis fournit à GCXONE l’accès à ces ressources via des interfaces API authentifiées.

Couche d’intégration – GCXONE

Le couche d’intégration GCXONE se connecte à l’environnement CathexisVision et récupère les ressources dont GCXONE a besoin.

À cette couche, GCXONE :

  • Découvre et identifie les caméras disponibles
  • Récupère les informations des caméras et les flux disponibles
  • Accède aux vidéos en direct et enregistrées
  • Gère les opérations PTZ prises en charge
  • Récupère les images de référence lorsque nécessaire
  • Reçoit et traite les informations d’événements et d’alarmes prises en charge

Cathexis fournit les ID de caméras, les URL de flux en direct, les pistes de révision (vidéo enregistrée) et les informations PTZ prises en charge via l’API, que GCXONE utilise pour exécuter ces opérations.

Couche de surveillance – GCXONE

La couche de surveillance est l’endroit où les informations Cathexis intégrées sont mises à disposition des opérateurs via GCXONE.

Les opérateurs peuvent utiliser GCXONE pour :

  • Voir en direct la vidéo de la caméra
  • Examiner les enregistrements lorsque pris en charge
  • Recevoir et enquêter sur les alarmes et événements
  • Accéder aux contrôles PTZ pris en charge

Cette couche fournit la vue opérateur tandis que CathexisVision continue de gérer l’infrastructure vidéo sous‑jacente et l’environnement d’enregistrement.

Configuration Cathexis

Cette section décrit la configuration CathexisVision requise avant de connecter le système à GCXONE. Effectuez les étapes dans l’ordre ci‑dessous afin que les caméras, flux vidéo, événements et alarmes techniques soient disponibles pour l’intégration GCXONE.

Remarque : Les options exactes disponibles peuvent varier selon la version de CathexisVision, les pilotes installés et les fonctionnalités sous licence.

Étape 1 : Créer ou sélectionner le Site Cathexis

Un SiteLe Site regroupe les serveurs Cathexis et les ressources appartenant au même déploiement. Les caméras et les appareils intégrés sont configurés sur les serveurs du Site. Si le serveur Cathexis est déjà installé en tant que site à serveur unique, utilisez le Site existant plutôt que d’en créer un autre.

Navigation : Fichier → Enterprise manager

Créer ou sélectionner le site requis et vérifier que le serveur Cathexis est disponible.

Onglet Enterprise manager de CathexisVision répertoriant le site disponible.

Étape 2 : Ajouter et vérifier les caméras

Ajouter les caméras qui seront surveillées via GCXONE.

Navigation:Site → Open → Setup → Configure Servers → Caméras

Cliquer Nouveau pour ouvrir le Nouvelle caméra assistant. Cathexis fournit les champs de connexion requis en fonction du pilote de caméra sélectionné.

Saisir les détails de connexion requis :

  • Pilote
  • Adresse IP
  • Entrée vidéo, le cas échéant
  • Port
  • Login (nom d'utilisateur de la caméra)
  • Mot de passe (mot de passe de la caméra)

Sélection du pilote de caméra

Les Caméras peuvent être ajoutées en utilisant soit le pilote spécifique à la caméra ou le Generic Encoder pilote.

  • Pilote spécifique à la caméra : Prend en charge les capacités d'intégration fournies par le pilote sélectionné, y compris le streaming, les Événements et le PTZ lorsqu'ils sont pris en charge.
  • Encodeur générique : Peut être utilisé lorsqu'aucun pilote spécifique à la caméra n'est disponible. Avec le pilote Encodeur générique, le streaming En direct et les Événements sont pris en charge, mais le contrôle PTZ n'est pas disponible.
Recommandé : Utiliser le pilote spécifique à la caméra chaque fois que le modèle de caméra requis est pris en charge. Utiliser l'Encodeur générique lorsque seule la diffusion En direct et la fonctionnalité d'Événement sont requises.

La caméra doit être connectée avec succès et afficher la vidéo avant de continuer.

Dialogue Nouvelle caméra avec les champs Pilote, Adresse IP, Entrée vidéo, Port, Login et Mot de passe.

Vérification de la caméra

Après avoir ajouté la caméra, vérifier que :

  • La vidéo En direct est disponible.
  • La caméra n'affiche pas de défaut de connexion.
  • La configuration d'Enregistrement requise est disponible si la Lecture est requise.

Cela garantit que GCXONE peut récupérer les informations de la caméra et les ressources vidéo via Cathexis.

Étape 3 : Configurer la station de base API GCXONE

Pour la livraison des Événements, Cathexis utilise un API Base Station comme destination pour les Alarmes.

La Station de base doit pointer vers le GCXONE service endpoint qui reçoit les Alarmes Cathexis.

Navigation : Site → Setup → Configure Servers → Base-stations

Créer une nouvelle Station de base et sélectionner :

  • Nom : Un nom descriptif, tel que API-BASE
  • Type : API
  • Adresse : https://cathexisproxy.nxgen.cloud/eventIngest
  • Port : 443
  • Utilisateur : Saisir l'Identifiant unique de l'Appareil provenant de GCXONE. GCXONE l'utilise pour associer les Alarmes entrantes à l'Appareil correct.

Cathexis prend en charge les Stations de base de type API pour l'envoi des Alarmes vers un système externe.

Onglet Stations de base du serveur avec la Station de base API configurée affichée et le bouton Nouveau mis en évidence.
Dialogue Modifier API-BASE avec le Type réglé sur API, l'adresse cathexisproxy.nxgen.cloud/eventIngest, le port 443 et le champ Utilisateur.
Important : Le point de terminaison GCXONE doit être accessible depuis le serveur Cathexis. Les règles réseau/pare-feu doivent permettre au serveur Cathexis d'envoyer les requêtes d'Alarme au point de terminaison GCXONE configuré.

Étape 4 : Configurer les Alarmes d'Événement

Les événements Cathexis déterminent quand une Alarme est générée et quelle action doit être exécutée.

Avant de créer un événement, vérifier que les ressources requises sont déjà configurées, telles que :

  • Caméra
  • Analytique vidéo ou déclencheur de Mouvement, si nécessaire
  • Base de données d'Enregistrement (voir Étape 7)
  • Autres entrées ou déclencheurs requis

Cathexis recommande de configurer ces ressources avant de créer l'événement.

Navigation : Site → Setup → Configure Servers → Events

Cliquer sur Nouveau pour créer l'événement requis.

Configurer l'événement selon le scénario de surveillance requis et sélectionner le déclencheur approprié (les enregistrements de Mouvement sont recommandés). Régler le déclencheur Temps de maintien à 0 afin que les événements soient envoyés à GCXONE immédiatement.

Nouvelle boîte de dialogue d'événement dans l'onglet Général, avec les champs Nom, Description, Planification et Priorité.
Nouvelle boîte de dialogue de déclencheur avec Déclencheur réglé sur Mouvement, Temps de maintien à 0 s, et Planification réglée sur Toujours.

Description de l'événement

  • Nom : Saisir un nom d'alarme clair (facultatif).
  • Description (important) : Saisir $input_name.

Le Description configurée pour l'événement sera incluse dans les informations d'alarme envoyées via l'API Cathexis.

Étape 5 : Configurer l'événement pour appeler la station de base GCXONE

Après avoir créé le déclencheur d’événement, configurer son action afin que l’alarme soit envoyée à la GCXONE API Base Station.

Dans l'événement Actions onglet, cliquer sur Nouveau et ajouter les deux Enregistrer Caméra et Appeler station‑base. Les deux sont requis afin que les informations de la caméra soient envoyées avec chaque événement.

Sélectionner le GCXONE API Base Station que vous avez créé à l'étape 3 comme destination.

Cathexis prend en charge un Premier essai station de base et une optionnelle Deuxième essai station de base si une destination secondaire est requise.

Cocher toutes les cases sur le Appeler station‑base et Aperçu Alarme onglets.

Dans le Ressources onglet, sélectionner Utiliser les ressources de déclenchement en bas.

Nouvel onglet Actions d'événement avec Enregistrer caméra et Appeler station de base mis en évidence dans le menu Nouveau.
Dialogue Appeler station de base sur l'onglet Aperçu Alarme, avec Activer aperçu alarme, Utiliser les caméras de déclenchement, et Inclure les informations de déclenchement cochés, ainsi que les comptes d'images pré- et post-événement.
Nouvel onglet Ressources d'événement avec Utiliser les ressources de déclenchement cochées.

Étape 6 : Configurer les Alarmes techniques

Les alarmes techniques sont utilisées pour des conditions du système ou de l'infrastructure plutôt que pour des événements de caméra normaux.

Exemples pris en charge par Cathexis :

  • Défaillances de Caméra
  • Problèmes de base de données
  • Erreurs de disque
  • Connectivité réseau
  • Échec d'enregistrement
  • Défaillance logicielle
  • Problèmes de base de données d'intégration
  • Conditions de surveillance du serveur

Navigation : LOCATION → Configuration → Configurer les serveurs → Alarmes techniques

Créer les alarmes techniques individuelles requises pour le déploiement.

Pour chaque alarme technique, configurer :

  • Nom d'alarme descriptif (facultatif)
  • Condition technique requise
  • Répéter les alarmes au maximum une fois toutes les, si nécessaire
  • Appeler station de base activé, avec la station de base GCXONE API sélectionnée
Liste des alarmes techniques avec Appeler-station de base activé et API-BASE attribué à chaque alarme.
Modifier le dialogue DéfaillancesCaméra avec Appeler station de base cochée et API-BASE sélectionnée comme Première tentative.

Étape 7 : Configurer la base de données

Les intégrations Cathexis utilisent une Base de données. Si la base de données n'a pas été préalablement initialisée sur le serveur, l'initialiser avant de configurer l'intégration.

Navigation :Site → Configuration → Bases de données

Si nécessaire :

  1. Initialiser la base de données.
  2. Sélectionner la partition appropriée.
  3. Allouer la taille de base de données requise.
  4. Créer la base de données d'intégration requise.

La base de données est utilisée par Cathexis pour stocker les données et événements liés à l'intégration.

Page Serveur bases de données affichant les bases de données d'enregistrement et l'utilisation des partitions, avec le bouton Nouveau mis en évidence.

Étape 8 : Configurer les appareils d'intégration

Si l'intégration GCXONE utilise Cathexis Appareils d'intégration, les configurer via le Appareils d'intégration panneau.

Navigation : Configuration → Configurer les serveurs → Appareils d'intégration

Cliquez sur Nouvel appareil, sélectionnez le pilote approprié, puis poursuivez la configuration de l'appareil.

Cathexis fournit des onglets de configuration pour l'appareil intégré, incluant Objets, Propriétés d'objet, Événements d'appareil, Groupes d'objets et Informations générales, selon l'intégration.

Page des appareils d’intégration avec le nouvel appareil mis en évidence et la liste Sélectionner un pilote ouverte.

Configurer l'API Cathexis

Important : GCXONE utilise le API Cathexis pour récupérer des informations telles que les détails du site, les ressources caméra, les flux en direct, les pistes enregistrées, les images de référence et les contrôles pris en charge. L'API Cathexis utilise le port HTTP API standard 33104/TCP. Si HTTPS est requis, utilisez un proxy SSL/TLS devant l'API, comme décrit dans la documentation de l'API Cathexis.

Guide de configuration Cathexis avec GCXONE

Configuration GCXONE

Dans le Fournisseur de services paramètres, ouvrez Paramètres additionnels → Propriété personnalisée et ajoutez la propriété suivante :

  • Type de paramètre : Chaîne
  • Nom du paramètre : Cathexis_Device_Custom_baseUrl
  • Valeur du paramètre : https://cathexisproxy.nxgen.cloud/
Propriété personnalisée du Fournisseur de services GCXONE avec un paramètre de type Chaîne nommé Cathexis_Device_Custom_baseUrl défini sur https://cathexisproxy.nxgen.cloud/.

Exigences de configuration

Lorsque vous ajoutez l'appareil Cathexis dans GCXONE, saisissez les détails suivants :

  1. Appareil : Cathexis
  2. Nom : Un nom pour l’appareil.
  3. Adresse IP ou nom d’hôte : L’adresse IP ou le nom d’hôte du serveur Cathexis accessible depuis GCXONE.
  4. Nom d’utilisateur : Identifiants d’utilisateur Cathexis valides avec l’accès API requis.
  5. Mot de passe : Mot de passe pour l’utilisateur Cathexis configuré.
  6. Activer HTTPS : Activer cette option si l’API Cathexis est configurée pour utiliser HTTPS.
  7. Port HTTP : Le port HTTP configuré pour la communication de l’API Cathexis.
  8. Port HTTPS : Saisir le port HTTPS lorsque HTTPS est activé.
  9. Fuseau horaire : Sélectionner le fuseau horaire de l’appareil.
Dialogue GCXONE Modifier l’appareil avec Appareil défini sur Cathexis, affichant les paramètres de connexion (Adresse IP, nom d’utilisateur, mot de passe, Activer HTTPS, port HTTP 33104) et le fuseau horaire.
Cette page vous a-t-elle été utile ?

Merci — votre retour est transmis à l’équipe responsable de cette page.

Notes de version

Sachez quand une nouveauté est livrée

Nouvelles fonctionnalités, correctifs et mises à jour des intégrations pour GCXONE, dans votre boîte de réception dès leur publication.

Nous envoyons d'abord un lien de confirmation. Chaque message contient un lien de désabonnement.