Hoja de repaso: Guide de connexion Caméra IP à WATCHIN

1. 📌 L'essentiel

• Vérifier si la caméra IP est accessible depuis Internet (port 554, IP publique).
• Identifier et tester l’URL RTSP spécifique à la marque (ex : Hikvision, Dahua).
• Utiliser VLC pour valider le flux RTSP.
• Exposer le flux via ngrok ou MediaMTX pour accès distant ou local.
• Modifier l’URL RTSP pour intégrer l’adresse ngrok.
• Ajouter la caméra dans WATCHIN, puis tester et activer l’IA.
• Vérifier la stabilité, la qualité d’image et la précision du détection.
• Protéger l’accès, éviter de partager l’URL RTSP, penser à fermer ngrok après usage.
• Résolution des erreurs fréquentes : identifiants, timeout, flux introuvable, codecs incompatibles.
• Codec recommandé : H.264, éviter H.265 pour meilleure compatibilité.

2. 🧩 Structures & Composants clés

• Caméra IP — dispositif source du flux vidéo en RTSP.
• URL RTSP — lien de connexion, spécifique à chaque marque ou modèle.
• VLC — lecteur pour tester le flux en local.
• Ngrok — outil pour exposer en TCP le flux RTSP à distance.
• MediaMTX — alternative pour générer des flux HLS ou RTSP local.
• Proxy local (portproxy, socat) — pour accès sécurisé sur réseau local.
• Interface WATCHIN — plateforme d’intégration et gestion de la caméra.

3. 🔬 Fonctions, Mécanismes & Relations

• La caméra envoie un flux RTSP à une URL spécifique selon la marque.
• VLC sert à tester la disponibilité et la qualité du flux.
• Ngrok convertit cette URL en une adresse accessible via TCP du type : tcp://X.tcp.ngrok.io:PORT.
• L’URL RTSP de WATCHIN doit être modifiée : IP remplacée par l’adresse ngrok.
• La mise en place d’un proxy local ou socat permet une stabilité supplémentaire.
• Une fois ajoutée dans WATCHIN, la caméra doit être testée : visualisation, détection, comptage.
• La stabilité dépend du bon paramétrage de l’exposition du flux.
• L’analyse IA dépend de la connexion stable et de la qualité d’image.
• La sécurité doit être assurée : désactivation ngrok après usage, changement régulier d’URL.

4. Tableau comparatif : Exposition du flux RTSP

5. 🗂️ Diagramme Hiérarchique

Caméra IP
 ├─ Vérification flux RTSP avec VLC
 ├─ Exposition du flux
 │   ├─ Ngrok TCP (X.tcp.ngrok.io:PORT)
 │   └─ Socat/portproxy (si besoin)
 ├─ Transformation URL pour WATCHIN
 └─ Ajout dans WATCHIN
     ├─ Test connexion
     └─ Activation IA / Détection

6. ⚠️ Pièges & Confusions fréquentes

• Confondre URL RTSP d’origine (local) et celle modifiée ngrok.
• Oublier de tester avec VLC avant intégration.
• Ignorer le codec vidéo, privilégier H.264.
• Ne pas fermer ngrok après la session (risques sécurité).
• Se fier à une seule tentative, toujours vérifier les credentials.
• Oublier de changer l’URL après chaque redémarrage de ngrok.
• La lenteur ou instability dû à un mauvais paramétrage de proxy.
• Croire que tout flux RTSP est compatible sans test préalable.

7. ✅ Checklist Examen Final

• Vérifier si la caméra est accessible en ligne (port 554 ou autre).
• Identifier et tester l'URL RTSP dans VLC.
• Configurer ngrok ou Socat pour exposer le flux.
• Modifier l'URL RTSP en remplaçant IP par l’adresse ngrok.
• Ajouter la caméra dans WATCHIN avec tous les paramètres.
• Vérifier la vidéo en direct dans WATCHIN.
• Tester la détection d’objets, le comptage, la stabilité du flux.
• Assurer la sécurité de l’URL RTSP (ne pas partager).
• Confirmer la compatibilité du codec : préférer H.264.
• Ne pas oublier de fermer ngrok après utilisation.
• Vérifier les erreurs : timeout, flux introuvable, mauvais identifiants.
• Vérifier la durée de test : minimum 10-15 minutes.
• Modifier régulièrement l’URL pour éviter toute compromission.
• S’assurer que la caméra supporte bien RTSP et le codec sélectionné.
• Vérifier que le flux vidéo est en bonne qualité.
• S’assurer que l’analyse IA fonctionne et est bien activée.
• Se référer à la documentation du modèle de caméra pour URL RTSP.
• En cas de problème, tester MediaMTX en alternative.

---