Guide d'installation des SDK VisioForge .NET¶

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

VisioForge propose de puissants SDK multimédias pour les développeurs .NET qui permettent d'ajouter des fonctionnalités avancées de capture vidéo, d'édition, de lecture et de traitement multimédia à vos applications. Ce guide couvre tout ce qu'il faut savoir pour installer et configurer correctement nos SDK dans votre environnement de développement.

SDK .NET disponibles¶

VisioForge fournit plusieurs SDK spécialisés pour répondre à différents besoins multimédias :

Video Capture SDK .Net — pour capturer la vidéo depuis des caméras, enregistrer l'écran et diffuser en streaming
Video Edit SDK .Net — pour l'édition vidéo, le traitement et la conversion de formats
Media Blocks SDK .Net — pour construire des pipelines de traitement multimédia personnalisés
Media Player SDK .Net — pour créer des lecteurs multimédias personnalisés dotés de fonctionnalités avancées

Méthodes d'installation¶

Vous pouvez installer nos SDK selon deux méthodes principales :

Avec les fichiers d'installation¶

La méthode d'installation par fichier setup est recommandée pour les environnements de développement Windows. Cette approche :

Installe automatiquement toutes les dépendances requises
Configure l'intégration avec Visual Studio
Inclut des projets d'exemple pour démarrer rapidement
Fournit la documentation et des ressources supplémentaires

Les fichiers d'installation peuvent être téléchargés depuis les pages produit de chaque SDK sur notre site web.

Avec les paquets NuGet¶

Pour le développement multiplateforme ou les pipelines CI/CD, nos paquets NuGet offrent souplesse et intégration aisée :

Install-Package VisioForge.DotNet.Core

Des paquets d'interface utilisateur supplémentaires peuvent être nécessaires selon la plateforme cible :

Install-Package VisioForge.DotNet.Core.UI.MAUI
Install-Package VisioForge.DotNet.Core.UI.WinUI
Install-Package VisioForge.DotNet.Core.UI.Avalonia
Install-Package VisioForge.DotNet.Core.UI.Uno

Intégration et configuration de l'IDE¶

Nos SDK s'intègrent parfaitement aux environnements de développement .NET les plus répandus :

Intégration avec Visual Studio¶

Visual Studio offre l'expérience la plus complète avec nos SDK :

Prise en charge complète d'IntelliSense pour les composants du SDK
Débogage intégré pour les composants de traitement multimédia
Prise en charge du concepteur pour les contrôles visuels
Gestion des paquets NuGet

Pour des instructions détaillées de configuration de Visual Studio, consultez notre guide d'intégration Visual Studio.

Intégration avec JetBrains Rider¶

Rider offre une excellente prise en charge du développement multiplateforme :

Complétion de code complète pour les API du SDK
Fonctions de navigation intelligente pour explorer les classes du SDK
Gestion intégrée des paquets NuGet
Capacités de débogage multiplateforme

Pour les instructions spécifiques à Rider, consultez notre documentation d'intégration Rider.

Visual Studio pour Mac¶

Les utilisateurs de Visual Studio pour Mac peuvent développer des applications pour macOS, iOS et Android :

Gestionnaire de paquets NuGet intégré pour installer les composants du SDK
Modèles de projet pour une configuration rapide
Outils de débogage intégrés

Pour en savoir plus, consultez notre guide de configuration Visual Studio pour Mac.

Configuration spécifique à la plateforme¶

Configuration du framework cible¶

Chaque système d'exploitation requiert des paramètres de framework cible spécifiques pour une compatibilité optimale :

Applications Windows¶

Les applications Windows doivent utiliser le suffixe de framework cible -windows :

<TargetFramework>net8.0-windows</TargetFramework>

Cela permet d'accéder aux API spécifiques à Windows et aux frameworks d'interface utilisateur comme WPF et Windows Forms.

Développement Android¶

Les projets Android nécessitent le suffixe de framework -android :

<TargetFramework>net8.0-android</TargetFramework>

Assurez-vous que les workloads Android sont installées dans votre environnement de développement :

dotnet workload install android

Développement iOS¶

Les applications iOS doivent utiliser le framework cible -ios :

<TargetFramework>net8.0-ios</TargetFramework>

Le développement iOS requiert un Mac avec Xcode installé, même lorsque vous utilisez Visual Studio sur Windows.

Applications macOS¶

Les applications natives macOS utilisent le framework -macos ou -maccatalyst :

<TargetFramework>net8.0-macos</TargetFramework>

Pour les applications .NET MAUI ciblant macOS, utilisez :

<TargetFramework>net8.0-maccatalyst</TargetFramework>

Développement Linux¶

Les applications Linux utilisent le framework cible standard sans suffixe de plateforme :

<TargetFramework>net8.0</TargetFramework>

Assurez-vous que les workloads .NET requises sont installées :

dotnet workload install linux

Prise en charge des frameworks spécialisés¶

Applications .NET MAUI¶

Les projets MAUI nécessitent une configuration spéciale :

Ajoutez le paquet NuGet VisioForge.DotNet.Core.UI.MAUI
Configurez les permissions spécifiques à la plateforme dans votre projet
Utilisez les contrôles vidéo spécifiques à MAUI

Consultez notre guide MAUI détaillé pour les instructions complètes.

Framework Avalonia UI¶

Les projets Avalonia proposent une alternative d'interface utilisateur multiplateforme :

Installez le paquet VisioForge.DotNet.Core.UI.Avalonia
Utilisez les contrôles de rendu vidéo spécifiques à Avalonia
Configurez les dépendances spécifiques à la plateforme

Notre guide d'intégration Avalonia fournit les instructions de configuration complètes.

Applications Uno Platform¶

Les projets Uno Platform permettent de créer des applications pour Windows, Android, iOS, macOS et Linux à partir d'une seule base de code :

Ajoutez le paquet NuGet VisioForge.DotNet.Core.UI.Uno
Utilisez les contrôles vidéo spécifiques à Uno Platform
Configurez les redistribuables spécifiques à la plateforme

Consultez notre guide Uno Platform pour les instructions de configuration complètes.

Initialisation du SDK pour les moteurs multiplateformes¶

Nos SDK comprennent à la fois des moteurs DirectShow spécifiques à Windows (comme VideoCaptureCore) et des moteurs X multiplateformes (comme VideoCaptureCoreX). Les moteurs X nécessitent une initialisation et un nettoyage explicites.

Initialisation du SDK¶

Avant d'utiliser un composant des moteurs X, initialisez le SDK :

// Initialiser au démarrage de l'application
VisioForge.Core.VisioForgeX.InitSDK();

// Ou utiliser la version asynchrone
await VisioForge.Core.VisioForgeX.InitSDKAsync();

Libération des ressources¶

Lorsque votre application se termine, libérez correctement les ressources :

// Nettoyer à la sortie de l'application (synchrone — DestroySDK n'a pas de variante asynchrone)
VisioForge.Core.VisioForgeX.DestroySDK();

Une mauvaise initialisation ou un nettoyage incorrect peut provoquer des fuites mémoire ou un comportement instable.

Contrôles de rendu vidéo¶

Chaque framework d'interface utilisateur requiert des contrôles vidéo spécifiques pour afficher le contenu multimédia :

Windows Forms¶

// Ajouter une référence à VisioForge.DotNet.Core
using VisioForge.Core.UI.WinForms;

// Dans votre formulaire
videoView = new VideoView();
this.Controls.Add(videoView);

Applications WPF¶

// Ajouter une référence à VisioForge.DotNet.Core
using VisioForge.Core.UI.WPF;

// Dans votre XAML
<vf:VideoView x:Name="videoView" />

Applications MAUI¶

// Ajouter une référence à VisioForge.DotNet.Core.UI.MAUI
using VisioForge.Core.UI.MAUI;

// Dans votre XAML
<vf:VideoView x:Name="videoView" />

Avalonia UI¶

// Ajouter une référence à VisioForge.DotNet.Core.UI.Avalonia
using VisioForge.Core.UI.Avalonia;

// Dans votre XAML
<vf:VideoView Name="videoView" />

Gestion des dépendances natives¶

Nos SDK s'appuient sur des bibliothèques natives pour des performances optimales. Ces dépendances doivent être correctement gérées lors du déploiement :

Windows : incluses automatiquement avec l'installation par fichier setup ou via les paquets NuGet
macOS/iOS : empaquetées avec les paquets NuGet, mais nécessitent une signature d'application correcte
Android : incluses dans les paquets NuGet avec la prise en charge des architectures appropriées
Linux : peuvent nécessiter des paquets système supplémentaires selon la distribution

Pour des instructions détaillées de déploiement, consultez notre guide de déploiement.

Résolution des problèmes d'installation courants¶

Si vous rencontrez des problèmes lors de l'installation :

Vérifiez la compatibilité du framework cible avec votre type de projet
Assurez-vous que toutes les workloads requises sont installées (dotnet workload list)
Recherchez des conflits de dépendances dans votre projet
Confirmez la bonne initialisation du SDK pour les moteurs X
Examinez les exigences spécifiques à la plateforme dans notre documentation

Exemples de code et ressources¶

Nous maintenons une vaste collection d'applications d'exemple sur notre dépôt GitHub pour vous aider à démarrer rapidement avec nos SDK.

Ces exemples couvrent des scénarios courants comme :

La capture vidéo depuis des caméras et des écrans
La lecture multimédia avec des contrôles personnalisés
L'édition et le traitement vidéo
Le développement multiplateforme

Consultez notre dépôt pour les derniers exemples de code et les bonnes pratiques d'utilisation de nos SDK.

Pour toute assistance supplémentaire ou question, veuillez contacter notre équipe de support technique ou consulter notre portail de documentation.