Aller au contenu

Guide d'installation et de déploiement Windows pour le SDK multiplateforme VisioForge

Video Capture SDK .Net Video Edit SDK .Net Media Player SDK .Net Media Blocks SDK .Net

Introduction à l'installation et au déploiement du SDK VisioForge

La suite SDK VisioForge offre de puissantes capacités multimédias pour vos applications .NET, prenant en charge la capture vidéo, l'édition, la lecture et le traitement multimédia avancé sur plusieurs plateformes. Ce guide complet couvre à la fois l'installation et le déploiement pour les applications Windows.

Installation

Les SDK sont accessibles sous deux formes : un fichier d'installation et des paquets NuGet. Le fichier d'installation offre un processus d'installation simple, garantissant que tous les composants nécessaires sont correctement configurés. Les paquets NuGet, quant à eux, proposent une approche flexible et modulaire pour intégrer les SDK dans vos projets, permettant des mises à jour faciles et une gestion des dépendances. Nous recommandons vivement l'utilisation des paquets NuGet en raison de leur commodité et de leur efficacité dans la gestion des dépendances et des mises à jour des projets.

Lors de la création de votre application, vous avez la possibilité de produire des versions x86 et x64. Cela permet à votre application de fonctionner sur une plus large gamme de systèmes, en accommodant différentes architectures matérielles. Il est toutefois important de noter que le fichier d'installation est exclusivement disponible pour l'architecture x64. Cela signifie que, bien que vous puissiez développer et compiler des builds x86, le processus initial d'installation et de configuration nécessitera un système x64.

IDE

Pour le développement, vous pouvez utiliser des environnements de développement intégrés (IDE) puissants comme JetBrains Rider ou Visual Studio. Ces deux IDE offrent des outils et des fonctionnalités robustes pour rationaliser le processus de développement sous Windows. Pour garantir une configuration fluide, consultez les guides d'installation correspondants. La page d'installation de Rider fournit des instructions détaillées pour configurer JetBrains Rider, tandis que la page d'installation de Visual Studio propose des conseils complets sur l'installation et la configuration de Visual Studio. Ces ressources vous aideront à démarrer rapidement et efficacement, en tirant parti des pleines capacités de ces environnements de développement.

Distribution et gestion des paquets

Les composants du SDK VisioForge pour Windows sont distribués sous forme de paquets NuGet, ce qui rend l'intégration simple avec les environnements de développement .NET modernes. Vous pouvez ajouter ces paquets à votre projet à l'aide de l'un des outils suivants :

  • Gestionnaire de paquets de Visual Studio
  • Gestionnaire NuGet de JetBrains Rider
  • Visual Studio Code avec les extensions NuGet
  • Intégration directe en ligne de commande à l'aide de la CLI .NET

Paquets de base requis

Chaque application Windows créée avec le SDK VisioForge requiert le paquet de base approprié selon l'architecture cible de votre application. Ces paquets contiennent les composants essentiels au fonctionnement du SDK.

Paquets de plateforme principaux

Note : pour les applications ciblant plusieurs architectures, vous devez inclure les deux paquets et implémenter une logique de sélection appropriée à l'exécution.

Paquets de composants optionnels

Selon les exigences de votre application, vous pouvez avoir besoin d'inclure des paquets supplémentaires pour des fonctionnalités spécialisées. Ces composants optionnels étendent les capacités du SDK dans divers domaines.

Traitement multimédia FFMPEG (recommandé)

Ces paquets fournissent une prise en charge complète des codecs pour une large gamme de formats multimédias grâce à l'intégration de la bibliothèque FFMPEG :

Pour les applications avec des contraintes de taille, des versions compressées de ces paquets utilisant la compression UPX sont disponibles :

Intégration cloud — Amazon Web Services

Pour les applications nécessitant une intégration de stockage cloud avec AWS S3 :

Lorsque ces paquets sont utilisés, le Media Block suivant devient disponible :

  • AWSS3SinkBlock — pour le stockage de fichiers multimédias dans des buckets S3

Vision par ordinateur avec OpenCV

Pour les applications nécessitant des capacités avancées de traitement d'image et de vision par ordinateur :

L'intégration OpenCV donne accès à des Media Blocks dans l'espace de noms VisioForge.Core.MediaBlocks.OpenCV, notamment :

  • Transformation d'image : CVDewarpBlock, CVDilateBlock, CVErodeBlock
  • Détection de contours et de caractéristiques : CVEdgeDetectBlock, CVLaplaceBlock, CVSobelBlock
  • Traitement de visages : CVFaceBlurBlock, CVFaceDetectBlock
  • Détection de mouvement : CVMotionCellsBlock
  • Reconnaissance d'objets : CVTemplateMatchBlock, CVHandDetectBlock
  • Amélioration d'image : CVEqualizeHistogramBlock, CVSmoothBlock
  • Suivi et superposition : CVTrackerBlock, CVTextOverlayBlock

Paquets de prise en charge de matériel spécialisé

Le SDK VisioForge fournit l'intégration avec des systèmes de caméras professionnelles et du matériel spécialisé. Incluez le paquet approprié lorsque vous travaillez avec des types d'appareils spécifiques.

Caméras Allied Vision

Pour l'intégration avec du matériel de caméras professionnelles Allied Vision :

Caméras Basler

Pour les applications utilisant des caméras industrielles Basler :

Caméras Teledyne/FLIR (SDK Spinnaker)

Pour l'imagerie thermique et les caméras FLIR spécialisées :

Prise en charge du protocole GenICam (GigE/USB3 Vision)

Pour les caméras utilisant le protocole standardisé GenICam :

Bonnes pratiques de déploiement

Lors du déploiement d'applications basées sur VisioForge pour Windows, prenez en compte ces recommandations :

  1. Choisissez les paquets d'architecture appropriés (x86 ou x64) en fonction de votre plateforme cible
  2. Incluez les paquets FFMPEG pour une prise en charge complète des formats multimédias
  3. N'incluez les paquets de matériel spécialisé que lorsque cela est nécessaire afin de minimiser la taille de déploiement
  4. Pour les applications sensibles à la sécurité, envisagez d'utiliser les versions compressées UPX pour obfusquer les bibliothèques natives
  5. Testez toujours votre déploiement sur un système propre pour vous assurer que toutes les dépendances sont correctement résolues

Dépannage des problèmes courants

Problèmes de déploiement

Si vous rencontrez des problèmes après le déploiement :

  1. Vérifiez que tous les paquets NuGet requis sont correctement inclus
  2. Vérifiez que l'architecture (x86/x64) correspond à la cible de votre application
  3. Assurez-vous que les bibliothèques natives sont extraites aux emplacements corrects
  4. Examinez les paramètres de sécurité et de permissions Windows susceptibles de restreindre les fonctionnalités multimédias

Problème de build des fichiers RESX WinForms

Vous pouvez parfois obtenir l'erreur suivante :

Error MSB3821: Couldn't process file Form1.resx due to its being in the Internet or Restricted zone or having the mark of the web on the file. Remove the mark of the web if you want to process these files.

L'erreur MSB3821 se produit lorsque Visual Studio ou MSBuild ne peut pas traiter un fichier de ressource .resx parce qu'il est marqué comme non fiable. Cela se produit quand le fichier porte la « Mark of the Web » (MOTW), une fonctionnalité de sécurité qui marque les fichiers téléchargés depuis Internet ou reçus de sources non fiables. La MOTW place le fichier dans la zone de sécurité Internet ou Restreinte, empêchant son traitement durant un build.

Comment corriger ce problème

Pour résoudre cette erreur, vous devez retirer la MOTW du fichier concerné :

Débloquer le fichier manuellement
  • Cliquez avec le bouton droit sur Form1.resx dans l'Explorateur de fichiers.
  • Sélectionnez Propriétés.
  • Dans l'onglet Général, recherchez un bouton ou une case Débloquer en bas.
  • Cliquez sur Débloquer, puis sur OK.
Débloquer via PowerShell (pour plusieurs fichiers)
  • Ouvrez PowerShell.
  • Naviguez jusqu'au répertoire de votre projet.
  • Exécutez la commande : Get-ChildItem -Path . -Recurse | Unblock-File
Débloquer l'archive ZIP avant l'extraction
  • Si vous avez téléchargé le projet sous forme de fichier ZIP, cliquez avec le bouton droit sur le fichier ZIP.
  • Sélectionnez Propriétés.
  • Cliquez sur Débloquer, puis extrayez les fichiers.

En débloquant le fichier, vous supprimez la MOTW, ce qui permet à Visual Studio de le traiter normalement durant le build.

Pour toute assistance supplémentaire, visitez le site de support VisioForge ou consultez la documentation de l'API.

Visitez notre page GitHub pour obtenir plus d'exemples de code.