Guide complet de déploiement pour Video Capture SDK .NET¶

Video Capture SDK .NET

Lors du déploiement du Video Capture SDK .NET vers des systèmes où le SDK n'est pas pré-installé, le déploiement correct des composants est essentiel au bon fonctionnement. Pour les applications AnyCPU, les redistribuables x86 et x64 doivent être déployés afin d'assurer la compatibilité avec différentes architectures système.

Vue d'ensemble des options de moteur¶

Moteur VideoCaptureCoreX (compatibilité multiplateforme)¶

Pour les scénarios de déploiement multiplateforme, consultez notre guide de déploiement complet qui détaille les exigences spécifiques à chaque plateforme et les options de configuration.

Moteur VideoCaptureCore (plateforme Windows)¶

Le moteur VideoCaptureCore est optimisé spécifiquement pour les environnements Windows et offre plusieurs approches de déploiement en fonction des besoins de votre application et des contraintes de l'environnement cible.

Méthodes de déploiement¶

Distribution par paquets NuGet (sans privilèges administrateur)¶

L'approche par paquets NuGet propose une méthode de déploiement simplifiée qui ne nécessite pas de privilèges administrateur, ce qui la rend idéale pour les environnements restreints ou pour le déploiement vers plusieurs systèmes sans accès élevé.

Ajoutez les paquets NuGet requis à votre projet d'application : après la compilation, les fichiers redistribuables nécessaires seront automatiquement inclus dans le dossier de votre application. Cette méthode simplifie la gestion des dépendances tout en garantissant la disponibilité de tous les composants requis.

Paquets NuGet essentiels¶

Composants de base (obligatoires) :

• Paquet de base du SDK : x86 | x64 | ARM64 (.NET 5 ou ultérieur)
• Video Capture SDK : x86 | x64 | ARM64 : pas encore disponible

Paquets spécifiques à certaines fonctionnalités :

• Intégration FFMPEG (pour la sortie fichier / le streaming réseau) : x86 | x64
• Prise en charge de la sortie MP4 : x86 | x64
• Intégration source VLC (pour les sources fichier / caméra IP) : x86 | x64 | ARM64
• Format de sortie WebM : x86
• Prise en charge des formats XIPH (Ogg, Vorbis, FLAC) : x86 | x64
• Filtres LAV : x86 | x64
• Prise en charge de la caméra virtuelle : x86 | x64 | ARM64

Windows ARM64 : les filtres LAV existent uniquement en x86 et x64. Il n'en existe aucune version ARM64 en amont, le SDK ne fournit donc pas de paquet LAV ARM64, et la plupart des autres filtres DirectShow des moteurs classiques n'ont pas encore de version ARM64 non plus. Une application exécutée en tant que processus ARM64 ne peut pas les charger. Les applications AnyCPU s'y exécutent généralement aussi en ARM64. Sous Windows ARM64, utilisez VideoCaptureCoreX ou Media Blocks SDK .NET, ou compilez l'application pour x64 (PlatformTarget défini sur x64 ; elle s'exécute alors en émulation).

Note : lorsque vous utilisez le paquet Virtual Camera, l'enregistrement supplémentaire des fichiers de caméra est requis tel que décrit dans la section Installation manuelle si vous souhaitez que la caméra virtuelle soit accessible depuis des applications externes. Sous Windows ARM64, les versions x64 et ARM64 partagent un même enregistrement : enregistrez la version qui correspond aux applications qui utiliseront la caméra, car la dernière enregistrée remplace l'autre.

Déploiement par installateur silencieux (privilèges administrateur requis)¶

Pour les scénarios où l'accès administrateur est disponible, les installateurs silencieux offrent une approche de déploiement simplifiée qui gère automatiquement l'enregistrement des composants.

Composants de base :

• Paquet de base (obligatoire) : x86 | x64
• Assemblies .NET : peuvent être installés dans le Global Assembly Cache (GAC) ou utilisés depuis un dossier local

Installateurs spécifiques à certaines fonctionnalités :

• Intégration FFMPEG : x86 | x64
• Prise en charge de la sortie MP4 : x86 | x64
• Intégration source VLC : x86 | x64
• Prise en charge de formats supplémentaires : WebM (x86) et formats XIPH (x86 | x64)
• Filtres LAV : x86 | x64

Note de désinstallation : pour supprimer le paquet, exécutez l'exécutable d'installation avec les privilèges administrateur en utilisant le paramètre /x //.

Processus d'installation manuelle¶

Pour un contrôle complet sur le processus de déploiement ou dans les environnements avec des exigences spécifiques, l'installation manuelle offre la plus grande flexibilité :

1. Dépendances d'exécution : installez ou copiez les DLL d'exécution VC++ 2022 (v143) (x86/x64) et OpenMP. Avec des droits administrateur, utilisez les redists exe ou les modules MSM ; sinon, copiez-les directement dans le dossier de l'application.

2. Composants de base : copiez les DLL VisioForge_MFP/VisioForge_MFPX (ou versions x64) du dossier Redist\Filters vers le répertoire de votre application.

3. Assemblies .NET : copiez les assemblies dans le dossier de votre application ou installez-les dans le GAC.

4. Filtres DirectShow : copiez les filtres DirectShow du SDK soit dans le dossier de votre application, soit dans un dossier redist dédié (configuré via la propriété CustomRedist_Path).

5. Configuration : définissez la propriété CustomRedist_Enabled à true dans l'événement Load de la fenêtre.

6. Gestion de l'architecture : pour les filtres LAV (qui utilisent des noms identiques pour les versions x64 et x86), utilisez des dossiers redist distincts pour chaque architecture.

7. Configuration du chemin : si votre exécutable d'application réside dans un emplacement différent, ajoutez le dossier des filtres à la variable d'environnement système PATH.

Composants de base¶

Fonctionnalités de base :

• Filtres de base : VisioForge_BaseFilters.ax / VisioForge_BaseFilters_x64.ax
• Effets vidéo : VisioForge_Video_Effects_Pro.ax / VisioForge_Video_Effects_Pro_x64.ax
• Traitement audio : VisioForge_MP3_Splitter.ax / VisioForge_MP3_Splitter_x64.ax, VisioForge_Audio_Mixer.ax / VisioForge_Audio_Mixer_x64.ax

Effets audio hérités :

• VisioForge_Audio_Effects_4.ax / VisioForge_Audio_Effects_4_x64.ax

Composants spécifiques à certains formats¶

Sortie MP3 :

• VisioForge_LAME.ax / VisioForge_LAME_x64.ax

Sortie MP4/M4A :

• Version héritée : VisioForge_AAC_Encoder.ax, VisioForge_H264_Encoder_XP.ax, VisioForge_MP4_Muxer.ax avec bibliothèques de support
• Version 10 : VisioForge_AAC_Encoder_v10.ax, VisioForge_H264_Encoder.ax, VisioForge_MP4_Muxer_v10.ax avec bibliothèques de support
• Version 11 / Encodage matériel : VisioForge_MFT.dll, VisioForge_MF_Mux.ax (avec variantes x64)

Sortie WebM :

• Multiplexeur : VisioForge_WebM_Mux.ax / VisioForge_WebM_Mux_x64.ax
• Encodeurs : VisioForge_WebM_Vorbis_Encoder.ax, VisioForge_WebM_VP8_Encoder.ax
• Amélioration audio : VisioForge_Audio_Enhancer.ax / VisioForge_Audio_Enhancer_x64.ax

Prise en charge Ogg/FLAC :

• FLAC : VisioForge_Xiph_FLAC_Encoder.ax / VisioForge_Xiph_FLAC_Encoder_x64.ax
• Ogg Vorbis : VisioForge_Xiph_Ogg_Mux.ax, VisioForge_Xiph_Vorbis_Encoder.ax (avec variantes x64)

Composants de streaming et de sources¶

Streaming RTSP :

• VisioForge_RTSP_Sink.ax / VisioForge_RTSP_Sink_x64.ax
• Filtres MP4 (à l'exception du multiplexeur)

Intégration source VLC :

• VisioForge_VLC_Source.ax / VisioForge_VLC_Source_x64.ax
• Nécessite de copier tous les fichiers du dossier Redist\VLC, l'enregistrement COM et la configuration appropriée des variables d'environnement

Intégration FFMPEG :

• VisioForge_FFMPEG_Source.ax / VisioForge_FFMPEG_Source_x64.ax
• Nécessite tous les fichiers du dossier Redist\FFMPEG et la mise à jour de la variable PATH

Prise en charge des sources RTSP/RTMP/HTTP :

• VisioForge_RTSP_Source.ax, VisioForge_RTSP_Source_Live555.ax
• Nécessite FFMPEG, VLC ou les filtres LAV

Composants spécialisés¶

Capture d'écran :

• VisioForge_Screen_Capture_DD.ax / VisioForge_Screen_Capture_DD_x64.ax

Capture audio :

• VisioForge_WhatYouHear_Source.ax / VisioForge_WhatYouHear_Source_x64.ax
• VisioForge_ASIO_Source.ax / VisioForge_ASIO_Source_x64.ax (périphériques ASIO)

Caméras MJPEG :

• VisioForge_MJPEGDec.ax / VisioForge_MJPEGDec_x64.ax

Caméra virtuelle :

• VisioForge_Virtual_Camera.ax / VisioForge_Virtual_Camera_x64.ax
• VisioForge_Virtual_Audio_Card.ax / VisioForge_Virtual_Audio_Card_x64.ax
• Windows ARM64 : VisioForge_Virtual_Camera_arm64.ax et VisioForge_Virtual_Audio_Card_arm64.ax, dans le dossier arm64 de l'application (avec VisioForge_Bridge_Video_arm64.ax et VisioForge_Bridge_Audio_arm64.ax, nécessaires à la capture séparée et aux sources de caméra IP avec ForcedFramerate)

Traitement vidéo :

• Push Source : VisioForge_Push_Video_Source.ax / VisioForge_Push_Video_Source_x64.ax
• Streaming réseau : VisioForge_Network_Streamer_Audio.ax, VisioForge_Network_Streamer_Video.ax
• Chiffrement vidéo : plusieurs composants incluant déchiffreurs, encodeurs et bibliothèques de support
• Image dans l'image : VisioForge_Video_Mixer.ax / VisioForge_Video_Mixer_x64.ax

Enregistrement des filtres¶

Pour l'enregistrement COM de tous les filtres DirectShow dans un dossier spécifique, vous pouvez déployer l'utilitaire reg_special.exe du SDK dans le répertoire des filtres et l'exécuter avec les privilèges administrateur pour automatiser le processus d'enregistrement.