---
title: "Hanwha-Techwin"
source: /fr/gcxone/devices/hanwha-techwin
locale: fr
updated: 2026-09-29
---
## Introduction

GCXONE s'intègre aux caméras Hanwha Vision à l'aide de SUNAPI pour la découverte d'appareils et l'intégration d'événements/appareils. Une fois l'appareil ajouté, le flux de la caméra est utilisé par le GCXONE **Visionneuse vidéo** pour la surveillance en direct. Les événements générés par l'appareil Hanwha sont reçus par le GCXONE et affichés dans **Recherche vidéo**.

## Prérequis

- La caméra Hanwha Vision est alimentée et accessible depuis l'environnement GCXONE.
- L'adresse IP de la caméra est connue et stable/réservée.
- Des identifiants d'administrateur de caméra valides sont disponibles.
- Le trafic requis HTTP/HTTPS, RTSP et SUNAPI pour la découverte/l'intégration est autorisé par le réseau/le pare-feu.
- Le firmware de la caméra prend en charge les fonctionnalités SUNAPI requises par l'intégration GCXONE.
- L'heure/la date de la caméra est correcte et synchronisée lorsque possible ; des horodatages corrects sont importants pour la recherche et la corrélation d'événements.
- Pour les événements de Mouvement/Analytique, la caméra est installée de façon à ce que la zone de déplacement des personnes/objets souhaitée soit visible.

## Configuration Hanwha-Techwin

La configuration des événements est effectuée sur la caméra Hanwha Vision. Les noms exacts des menus varient selon le modèle et le firmware de la caméra. Certains modèles P Series et X-Core/Plus utilisent **Configuration de règle d'événement**, tandis que d'autres modèles peuvent encore utiliser **Configuration d'événement**.

### Activer la Source d'Événement/Analytique

**Étape 1 :** Se connecter à la caméra Hanwha Vision via son interface web.

**Étape 2 :** Ouvrir **Configuration**.

**Étape 3 :** Aller à **Événement** / **Analytique** selon le modèle de la caméra (par exemple, **Événement** \> **Configuration d'événement**), puis sélectionner le canal (par exemple, **CH 1**).

**Étape 4:** Pour les événements de mouvement, activer **Détection de mouvement** et configurer la zone de détection requise.

**Étape 5:** Pour les événements IA/IVA, activer l'analyse requise et configurer le type de ligne/zone/objet virtuel tel que pris en charge par la caméra.

**Étape 6:** Appliquer/enregistrer les paramètres.

Le flux de travail de détection de mouvement est : activer la détection de mouvement, sélectionner une zone de détection, dessiner la zone requise sur la vue de la caméra, puis appliquer la configuration.

### Configurer la règle d'événement

Pour les caméras qui disposent de **Configuration de règle d'événement**, créer une règle d'événement qui possède le déclencheur requis et l'action d'événement. Une règle de validation typique est une règle de détection de mouvement activée pour le planning requis.

**Étape 1:** Naviguer vers **Configuration** \> **Événement** \> **Configuration de règle d'événement**.

**Étape 2:** Sélectionner **Ajouter** pour créer une règle.

**Étape 3:** Saisir un nom clair **Nom de la règle**, par exemple `NXGEN_Motion_Test`.

**Étape 4:** Sélectionner le canal.

**Étape 5:** Sous **Déclencheur d'événement**, sélectionner **Détection de mouvement**, **IVA**, Détection d'objets, Ligne virtuelle, Zone virtuelle, ou le déclencheur d'événement requis pris en charge par la caméra.

**Étape 6 :** Activer la règle et sélectionner le requis **Planification**.

**Étape 7 :** Sous **Action d'événement**, configurer l'action d'événement requise par le flux de travail de l'appareil/enregistrement.

**Étape 8 :** Enregistrer/appliquer la règle.

**Étape 9 :** Générer un véritable événement de test devant la caméra.

![Boîte de dialogue de configuration de règle d'événement Hanwha Vision affichant la liste des déclencheurs d'événement et l'option Ajouter une action sous Action d'événement](/api/media/file/02-event-rule-trigger-list-edited-f11e63bf.png?prefix=media)

![Boîte de dialogue de configuration de règle d'événement Hanwha Vision avec la détection de Mouvement sélectionnée pour le canal 1 et une action Enregistrer/Aller au préréglage pour les canaux 1 à 4](/api/media/file/03-event-rule-motion-action-edited-a7634894.png?prefix=media)

![Liste de configuration de règle d'événement Hanwha Vision avec la règle Mouvement réglée sur Activé](/api/media/file/04-event-rule-list-edited-e4ff83ee.png?prefix=media)

Il s'agit d'une illustration de référence ; les champs de l'interface Hanwha varient selon le modèle et le firmware.

La **Configuration de règle d'événement** page montre la règle Mouvement activée avec ses colonnes de déclencheur d'événement et d'action d'événement.

### Rendre les événements disponibles dans Hanwha Search

La séquence suivante est recommandée lorsque les événements de caméra doivent être visibles dans le Hanwha Vision **Recherche** interface.

**Étape 1 :** Activer la source analytique/événement : activer la détection de Mouvement, IVA, détection d'objets, ligne/zone virtuelle, ou l'analytique requis sur la caméra.

**Étape 2 :** Définir la zone de détection : tracer la zone de détection sur la zone réelle de déplacement de personnes/objets. Éviter de pointer la caméra vers un mur vide ou un arrière‑plan non pertinent.

**Étape 3 :** Créer/activer la règle d'événement : sous **Configuration de règle d'événement**, activer le déclencheur correspondant et enregistrer la règle.

**Étape 4 :** Configurer le planning d'enregistrement/événement : lorsque le modèle l'exige pour l'enregistrement/recherche d'événement, configurer le planning d'enregistrement pour inclure **Événement** ou **Événement/Continu**.

**Étape 5 :** Générer un événement de test : traverser/marcher dans la zone de détection configurée et attendre que la caméra enregistre l'événement.

**Étape 6 :**Confirmer l’événement côté caméra : utiliser les indicateurs En direct/Événement de la caméra ou les journaux, lorsqu’ils sont disponibles, pour vérifier que l’événement a été généré.

**Étape 7 :**Vérifier la recherche : ouvrir l’interface Hanwha Vision **Search**interface, sélectionner le canal/la plage horaire/le filtre d’événement appropriés, et confirmer que l’événement généré est renvoyé.

![Page de recherche Hanwha Vision avec CAM 01 sélectionnée sous Appareil cible, une date sélectionnée et l’événement marqué sur la chronologie](/api/media/file/05-hanwha-search-edited-e41d6633.png?prefix=media)

**Étape 8 :**Valider dans GCXONE : après que le même événement a été généré, confirmer que l’événement correspondant est reçu et affiché dans **Video Search** (voir Valider les événements dans GCXONE).

La séquence complète est : activer la détection de Mouvement requise, définir la zone de détection, configurer le comportement d’enregistrement/événement, puis activer la règle Mouvement dans **Event rule setup**.

![Page de configuration d’événement Hanwha Vision avec CH 1 sélectionnée, l’onglet Mouvement ouvert, la détection de Mouvement activée et une zone de détection dessinée](/api/media/file/01-event-setup-motion-edited-fbdfc2de.png?prefix=media)

## Guide de configuration Hanwha‑Techwin avec GCXONE

### Ajouter un appareil

**Étape 1 :**Dans GCXONE, accéder à **Configuration**et ouvrir le client et le site où la caméra sera ajoutée.

**Étape 2 :**Ouvrir l’onglet **Devices** et cliquer sur **Add New**. Le dialogue **Add Device** s’ouvre.

**Étape 3 :**Dans le**Device**dropdown, sélectionner **Hanwha-Techwin**.

**Étape 4 :**Saisir un **Name** pour l’appareil et, si nécessaire, sélectionner un groupe d’entités dans **Select Entity Group**.

**Étape 5 :** Sous **Paramètres de connexion**, saisissez le **Adresse IP ou nom d’hôte**, **Numéro de série**, **Nom d’utilisateur**, **Mot de passe**, **Port de Contrôle**, **Port RTSP**, **Port de Serveur** et **Port HTTPS**. Les valeurs des ports doivent correspondre à la configuration de la caméra.

**Étape 6 :** Sélectionnez le **Fuseau horaire** (obligatoire). Ajustez **Activer l'audio**, **Configuration de l'Appareil**, **Paramètres avancés** et **Emplacement** si nécessaire, et vérifiez que les champs obligatoires sont remplis.

**Étape 7 :** Sélectionnez **Découvrir**. GCXONE valide l'appareil et récupère les informations de périphérique/canal prises en charge.

**Étape 8 :** Après une découverte réussie, cliquez sur **Enregistrer** pour enregistrer l’appareil.

**Étape 9 :**Confirmer que l’appareil figure sous le site du client dans le **Appareils** onglet.

### Valider le Direct

Après l’enregistrement de l’appareil, la Caméra est disponible dans l’arbre d’appareils GCXONE.

**Étape 1 :** Ouvrir la **Visionneuse vidéo**.

**Étape 2 :** Dans **Explorateur d’appareils**, sur l’onglet **Appareils**, localiser le nouvel appareil Hanwha Vision ajouté.

**Étape 3 :** Faire glisser‑déposer l’appareil/canal sur la grille de visualisation vidéo, ou double‑cliquer dessus dans l’arbre d’appareils.

**Étape 4 :** Attendre que le Direct s’initialise.

**Étape 5 :** Vérifier que la vidéo en direct est visible et que le flux reste stable pendant plusieurs minutes.

### Valider les Événements dans GCXONE

Une fois la Caméra configurée et générant des événements, valider le chemin complet de l’événement.

**Étape 1 :** Déclencher l’événement configuré sur la Caméra.

**Étape 2 :** Confirmer que l’événement est généré par l’appareil Hanwha.

**Étape 3 :** Confirmer que GCXONE reçoit l’événement via l’intégration Hanwha‑Techwin (SUNAPI).

**Étape 4 :** Confirmer que l’événement est mappé au bon appareil/canal dans GCXONE.

**Étape 5 :** Ouvrir **Recherche vidéo** et vérifier que l’événement apparaît.

**Étape 6 :** Comparer l’horodatage de l’événement avec l’horodatage de la Caméra et l’horodatage de la Recherche vidéo.

**Étape 7 :**Répéter avec au moins deux ou trois événements pour vérifier la cohérence plutôt qu’avec un seul déclenchement réussi.

## Dépannage

| Symptôme | Vérifications probables | Action |
| --- | --- | --- |
| Échec de Découvrir | Accessibilité IP ; identifiants ; trafic de découverte SUNAPI ; port HTTP/HTTPS | Vérifier le chemin réseau et la connexion web de la caméra ; vérifier les ports configurés et les règles de pare‑feu. |
| L’Appareil enregistre mais le flux est vide | Port RTSP ; profil de flux ; codec ; identifiants ; réseau | Valider la disponibilité du RTSP et les paramètres du flux de la caméra ; essayer un profil H.264 pris en charge si le lecteur a des limitations de codec. |
| Le flux fonctionne mais aucun événement dans Recherche vidéo | La source d’événement désactivée ou mappage canal/événement incorrect | Vérifier d’abord la génération d’événements par la caméra ; puis valider la réception/mappage des événements GCXONE. |
| L’événement n’est pas présent dans Recherche Hanwha | Règle d’événement ; zone de détection ; planning ; configuration d’enregistrement | Vérifier que l’événement est réellement généré ; vérifier que le bon canal/plage horaire est sélectionné ; vérifier que la configuration d’événement/enregistrement est activée si nécessaire. |
| Les événements ont des horodatages incorrects | Décalage horaire Caméra/GCXONE | Synchroniser l’heure de la caméra et du serveur/NTP et répéter le test. |
| Événements faux fréquents | Zone de détection/sensibilité trop large | Réduire la zone de détection ; ajuster la sensibilité/durée minimale ; retester. |

### Notes sur le réseau et les protocoles

Hanwha Vision indique que la découverte SUNAPI utilise UDP 7701 et documente la communication web HTTP/HTTPS. Les ports exacts peuvent varier selon le rôle/modèle et la configuration de l’appareil, ainsi les valeurs affichées dans GCXONE doivent correspondre à la configuration de la caméra plutôt que de se fier à une valeur par défaut universelle.

**Important :**Le port RTSP doit être la valeur configurée/sup‑portée par la caméra spécifique. Ne pas supposer le port d’un autre appareil ou modèle d’enregistreur Hanwha.