Guide complet de l'intégration des caméras IP et des sources réseau¶

Video Capture SDK .Net VideoCaptureCoreX VideoCaptureCore

Prise en charge des plateformes¶

Pour les applications multiplateformes MAUI (base de code unique → Windows · macOS · iOS · Android), consultez le guide de la grille RTSP multi-caméras 4×4. Pour gérer les coupures de caméras, la logique de reconnexion et le FallbackSwitch automatique (texte / image / flux alternatif) sur tous les SDK, consultez le guide de reconnexion RTSP et de solution de repli.

Introduction aux sources vidéo réseau¶

Les applications vidéo modernes nécessitent souvent l'intégration de diverses sources vidéo réseau. Le Video Capture SDK pour .NET offre une prise en charge robuste de différents types de caméras IP et de flux vidéo réseau, permettant aux développeurs d'incorporer facilement de la vidéo réseau en direct dans leurs applications .NET.

Ce guide complet couvre toutes les sources réseau prises en charge et fournit des exemples d'implémentation clairs pour les frameworks VideoCaptureCore et VideoCaptureCoreX.

Types de caméras IP et de sources réseau pris en charge¶

Le SDK offre une compatibilité étendue avec diverses sources vidéo réseau, notamment :

• Caméras compatibles ONVIF — Standard industriel pour les produits de sécurité basés sur IP
• Caméras RTSP — Caméras utilisant le protocole Real-Time Streaming Protocol
• Caméras HTTP MJPEG — Streaming Motion JPEG sur HTTP
• Caméras et flux UDP — Flux basés sur le protocole User Datagram Protocol
• Caméras NDI — Caméras utilisant la technologie Network Device Interface
• Serveurs et caméras SRT — Protocole Secure Reliable Transport
• Serveurs VNC — Virtual Network Computing pour la capture d'écran
• Flux RTMP — Sources Real-Time Messaging Protocol
• Flux HLS — Sources HTTP Live Streaming
• Sources vidéo HTTP — Divers flux vidéo basés sur HTTP

Chaque protocole offre des avantages spécifiques selon les exigences de votre application, des besoins de faible latence à la transmission vidéo de haute qualité.

Vous cherchez les URL RTSP d'une marque de caméra spécifique ? Parcourez notre répertoire des marques de caméras IP pour des guides de connexion couvrant plus de 60 fabricants, dont Hikvision, Dahua, Axis, Reolink et bien d'autres.

Implémentation de source universelle pour les protocoles réseau¶

Notre SDK propose une approche universelle pour la prise en charge de la plupart des sources vidéo réseau, notamment RTSP, RTMP, HTTP, etc. Cette flexibilité permet aux développeurs de se concentrer sur la logique applicative plutôt que sur les détails d'implémentation propres à chaque protocole.

// Créer et configurer la source réseau
VideoCapture1.IP_Camera_Source = new IPCameraSourceSettings
{
    URL = new Uri("rtsp://192.168.1.100:554/stream1"), // L'URL du flux (Uri, pas string)
    Login = "admin", // Identifiants d'authentification optionnels
    Password = "password123",
    AudioCapture = true, // Mettre à true pour inclure l'audio depuis la source
    Type = IPSourceEngine.Auto_VLC // Le moteur de traitement à utiliser
};

// Configurer des paramètres FFMPEG personnalisés
VideoCapture1.IP_Camera_Source.FFMPEG_CustomOptions.Add("rtsp_transport", "tcp"); // Forcer le transport TCP
VideoCapture1.IP_Camera_Source.FFMPEG_CustomOptions.Add("timeout", "3000000"); // Définir le timeout en microsecondes
VideoCapture1.IP_Camera_Source.FFMPEG_CustomOptions.Add("buffer_size", "1000000"); // Ajuster la taille du tampon
VideoCapture1.IP_Camera_Source.FFMPEG_CustomOptions.Add("max_delay", "500000"); // Définir le délai maximum autorisé

// Préparer l'URL source avec authentification si nécessaire
var uri = new Uri("rtsp://192.168.1.100:554/stream1");
if (!string.IsNullOrEmpty(login) && !string.IsNullOrEmpty(password))
{
    uri = new UriBuilder(uri) { UserName = login, Password = password }.Uri;
}

// Créer la source universelle avec les paramètres souhaités
var source = await UniversalSourceSettings.CreateAsync(
    uri,
    renderAudio: true); // Inclure le flux audio

// Appliquer la source à l'objet de capture
VideoCapture1.Video_Source = source;

Implémentation MJPEG à faible latence¶

Pour les applications nécessitant une latence minimale, comme la surveillance ou les systèmes de contrôle en temps réel, le SDK propose une implémentation MJPEG spécialisée à faible latence, avec une latence typique inférieure à 100 ms.

// Créer l'objet de paramètres
var settings = new IPCameraSourceSettings
{
    URL = new Uri("http://192.168.1.100/video.mjpg"),
    Login = "admin",
    Password = "pass123",
    // Utiliser le moteur MJPEG dédié à faible latence
    Type = IPSourceEngine.HTTP_MJPEG_LowLatency
};

// Appliquer les paramètres à l'objet VideoCaptureCore
VideoCapture1.IP_Camera_Source = settings;

// Créer les paramètres de source HTTP MJPEG spécialisés
var mjpeg = await HTTPMJPEGSourceSettings.CreateAsync(
    new Uri("http://192.168.1.100/video.mjpg"),
    "admin", // Nom d'utilisateur
    "pass123"
);

// Appliquer les paramètres à l'objet VideoCaptureCoreX
VideoCapture1.Video_Source = mjpeg;

Implémentation Secure Reliable Transport (SRT)¶

SRT est un protocole moderne conçu pour le streaming vidéo fiable sur des réseaux imprévisibles. Il est particulièrement utile pour préserver la qualité dans des conditions réseau difficiles.

// Créer les paramètres de source SRT avec l'URL du serveur — CreateAsync attend un System.Uri, pas une chaîne.
var srt = await SRTSourceSettings.CreateAsync(new Uri("srt://streaming-server.example.com:7001"));

// Appliquer la source SRT à l'objet de capture
VideoCapture1.Video_Source = srt;

Gestion des déconnexions réseau¶

Toute implémentation robuste de source réseau doit gérer les interruptions de connexion avec élégance. Le SDK fournit des mécanismes intégrés pour détecter et répondre aux déconnexions réseau.

// DisconnectEventInterval se trouve sur IPCameraSourceSettings (accessible via VideoCapture1.IP_Camera_Source),
// pas sur VideoCaptureCore lui-même. Configurez-le avant de démarrer l'aperçu/la capture.
VideoCapture1.IP_Camera_Source.DisconnectEventInterval = TimeSpan.FromSeconds(5); // Vérifier toutes les 5 secondes

// L'événement de déconnexion EST sur VideoCaptureCore
VideoCapture1.OnNetworkSourceDisconnect += VideoCapture1_OnNetworkSourceDisconnect;

// Implémenter le gestionnaire d'événement de déconnexion
private void VideoCapture1_OnNetworkSourceDisconnect(object sender, EventArgs e)
{
    Invoke((Action)(
        async () =>
        {
            await VideoCapture1.StopAsync();

            // Notifier l'utilisateur
            MessageBox.Show(this, "Network source disconnected!");
        }));
}

Implémentation de la source VNC¶

Virtual Network Computing (VNC) permet de capturer les écrans de bureau distants comme sources vidéo, ce qui est utile pour les applications d'enregistrement d'écran et d'assistance à distance.

// Créer l'objet de paramètres de source VNC
var vncSettings = new VNCSourceSettings();

// Configurer en utilisant l'hôte et le port
vncSettings.Host = "remote-server.example.com";
vncSettings.Port = 5900; // Port VNC par défaut

// Ou configurer en utilisant le format URI
// vncSettings.Uri = "vnc://remote-server.example.com:5900";

// Définir les identifiants d'authentification
vncSettings.Password = "secure-password";

// Optionnel : configurer le comportement avancé du VNC
vncSettings.Shared = true;        // Partager le bureau avec d'autres clients
vncSettings.ViewOnly = true;      // Lecture seule, n'envoyer aucun événement d'entrée
vncSettings.Incremental = true;   // Utiliser les mises à jour incrémentales du framebuffer
vncSettings.RFBVersion = "3.8";   // Version du protocole RFB

// Appliquer les paramètres à l'objet de capture
VideoCapture1.Video_Source = vncSettings;

Bonnes pratiques pour les sources réseau¶

Pour des performances optimales lorsque vous travaillez avec des sources vidéo réseau :

1. Gestion du tampon : ajustez la mise en tampon selon la stabilité de la source et les exigences de latence
2. Gestion des erreurs : implémentez une gestion exhaustive des interruptions réseau
3. Authentification : utilisez toujours un stockage sécurisé des identifiants pour l'authentification de la caméra
4. Mise en pool des connexions : réutilisez les connexions lors de l'accès à plusieurs flux du même appareil
5. Considération de la bande passante : surveillez et gérez la consommation de bande passante, en particulier avec plusieurs sources

Conclusion¶

Le Video Capture SDK pour .NET offre une prise en charge complète des caméras IP et des sources réseau, permettant aux développeurs de créer des applications vidéo sophistiquées. Avec la prise en charge de multiples protocoles et des options de configuration flexibles, il s'adapte à un large éventail de cas d'usage, de la vidéosurveillance au streaming multimédia.

Pour des exemples d'implémentation supplémentaires et des scénarios d'utilisation avancés, explorez notre dépôt GitHub contenant des exemples de code complets.

Voir aussi¶

• Enregistrement pré-événement — enregistrement par tampon circulaire avec détection de mouvement pour caméras IP et webcams
• Capture de caméra IP vers MP4 — enregistrer la vidéo d'une caméra IP dans un fichier MP4
• Lecteur de codes-barres et QR code — scanner des codes-barres et QR codes depuis des flux vidéo de caméras IP

Visitez notre dépôt GitHub pour des exemples de code plus complets et des applications de démonstration.