Lernzettel: 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

Élément	Caractéristiques clés	Notes / Différences
URL RTSP	Format par marque : rtsp://user:pass@IP:554/chemin	Ex : Hikvision : Streaming/Channels/101
Test VLC	Valider le flux RTSP en lecture locale	Vérifier credentials et chemin
Ngrok	Exposer le flux TCP, adresse du type tcp://X.tcp.ngrok.io:PORT	Nécessite création et configuration
Socat / portproxy	Redirige port local vers adresse IP caméra	Accès en réseau local ou sécurisé
Transformation URL WATCHIN	Remplacer IP par adresse ngrok, conserver le reste du chemin	Ex: rtsp://user:pass@ngrok_address:PORT/chemin
Ajout dans WATCHIN	Nom, protocole RTSP, URL modifiée, test de connexion, activation IA	Vérification du flux et de la compatibilité
Tests complémentaires	Visualisation, détection, comptage, notifications, stabilité	Assurer la qualité et la réactivité

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.

---