> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/function-blocks/blocks-reference/input-output/image-inputs/camera-ip.md).

# Camera IP

Ce bloc de fonction lit les flux RTSP/HTTP des caméras dans un thread en arrière-plan et maintient la dernière image prête avec une utilisation CPU minimale. Il est conçu pour la surveillance en direct et pour alimenter de manière fiable les blocs de traitement d'image même en cas d'interruptions réseau.

## 📥 Entrées <a href="#inputs" id="inputs"></a>

Ce bloc de fonction n'a pas d'entrées.

## 📤 Sorties <a href="#outputs" id="outputs"></a>

`Image` Image courante récupérée depuis la caméra IP configurée.

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

`Status` — Affiche l'état de connexion actuel (exemples : Waiting for camera link, Connecting..., Live, Reconnecting...).

`Camera link` — Collez le lien RTSP/HTTP complet de votre caméra (par exemple rtsp\://camera-ip/stream).

`Username` — Nom d'utilisateur optionnel si l'authentification est requise.

`Password` — Mot de passe optionnel si l'authentification est requise.

(astuce) Après avoir modifié le lien de la caméra ou les identifiants, le bloc attend un court instant avant de se reconnecter afin que vous puissiez terminer la saisie.

## 🎯 Fonctionnalités clés <a href="#features" id="features"></a>

* Lecture en arrière-plan (thread) qui garde la dernière image disponible pour les blocs en aval tout en utilisant peu de CPU.
* Prise en charge des liens RTSP et HTTP, avec authentification optionnelle par `Username`/`Password`.
* Mises à jour automatiques du `Status` pour indiquer la progression de la connexion et les problèmes éventuels.
* Reconnexion automatique avec délais de nouvelle tentative croissants en cas d'échec.
* Conserve la dernière trame valable pendant les tentatives de reconnexion.
* Uploader de trames en arrière-plan optionnel (si configuré) pour transférer des images vers un service distant.

## ⚙️ Fonctionnement <a href="#running-mechanism" id="running-mechanism"></a>

* Saisissez un lien de caméra valide dans le contrôle `Camera link` (et les identifiants si nécessaire).
* Le bloc tentera de se connecter en arrière-plan et mettra à jour le contrôle `Status`.
* Une fois connecté, le bloc conserve en continu la trame la plus récente disponible sur la sortie `Image` pour que les autres blocs la consomment.
* En cas de problèmes de connexion, le bloc affiche des messages de statut et effectue des tentatives de reconnexion automatiques ; la dernière trame correcte reste disponible jusqu'à réception d'une nouvelle.

## 📝 Instructions d'utilisation <a href="#usage" id="usage"></a>

1. Entrez l'URL de la caméra dans `Camera link`.
2. Si la caméra nécessite une authentification, remplissez `Username` et `Password`.
3. Attendez que `Status` indique un état live/connected.
4. Connectez la sortie `Image` aux blocs de traitement ou de visualisation en aval.

Blocs en aval recommandés :

* Utilisez `Show Image` pour prévisualiser les trames.
* Utilisez `Image Resizer` ou `Image Resize` si vous devez réduire la taille des images avant traitement.
* Utilisez `Record Video` ou `Image Logger` pour sauvegarder des trames ou des enregistrements.
* Alimentez des blocs d'analyse/IA comme `Object Detection`, `Object Detection - Custom`, `Pose Estimation` ou `Mask Detection` pour de l'inférence en direct.
* Utilisez `Image ROI Select`, `Image ROI Polygon` ou `Image ROI Polygon Multi` pour recadrer ou limiter la zone de traitement avant détection.
* Utilisez `Background Removal (RMBG-1.4)` ou `Background Removal (BiRefNet)` si vous avez besoin d'extraire le premier plan.
* Combinez avec `Object_Detection_Tracker` pour maintenir les identités entre les images.

## 💡 Astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Si votre caméra supporte ONVIF et que vous préférez des captures ponctuelles plutôt qu'un flux continu, essayez `Camera IP (ONVIF)`.
* Pour des pipelines plus rapides, réduisez la résolution dans les paramètres de la caméra.
* Pour déboguer la connectivité, vérifiez le même URL dans un lecteur externe (par ex. VLC) et confirmez les identifiants.
* Utilisez `Show Image` pour vérifier le contenu de la trame avant de l'orienter vers des blocs de détection ou de journalisation.
* Pour enregistrer de longues sessions, préférez `Record Video` pour éviter d'encombrer le disque avec de nombreuses images individuelles ; utilisez `Image Logger` pour des sauvegardes sélectives.
* Si vous n'avez besoin d'analyser qu'une partie de la scène, recadrez avec `Image ROI Select` ou définissez des polygones avec `Image ROI Polygon Multi` pour réduire les fausses détections et accélérer le traitement.
* Combinez avec `Object Detection` (ou `Object Detection - Custom`) puis avec `Object_Detection_Tracker` pour des applications de suivi et de comptage (par exemple en alimentant les résultats dans `Traffic Intersection Analysis`).

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Pas de connexion / statut bloqué sur waiting : vérifiez que l'URL de la caméra est correcte et joignable sur le réseau. Testez le flux dans un lecteur externe.
* Erreurs d'authentification : vérifiez et ressaisissez `Username` et `Password`.
* Trames intermittentes ou reconnexions fréquentes : cela peut venir d'une instabilité réseau ou d'un problème côté caméra ; le bloc réessaiera automatiquement. Envisagez un réseau plus stable ou un enregistrement local.
* Trames vides ou non prises en charge : utilisez `Show Image` pour inspecter la sortie. Si le viewer signale des données non prises en charge, essayez un autre format de flux ou l'URL recommandée par le fabricant.
* Utilisation CPU élevée : si le traitement en aval est lourd, réduisez la résolution via `Image Resizer` ou traitez les images à un rythme inférieur en ajoutant une logique de limitation du flux.

Si vous avez besoin d'une interface caméra différente (USB, drivers spécialisés, ou snapshots ONVIF), consultez les blocs d'entrée d'image correspondants tels que `Camera USB` ou `Camera IP (ONVIF)` pour adapter le flux à votre matériel et workflow.