Intégrer les SDK VisioForge à des applications .NET MAUI¶

Try it Download free trial Compare .NET SDKs →

Vue d'ensemble¶

.NET Multi-platform App UI (MAUI) permet aux développeurs de créer des applications multiplateformes pour mobile et bureau à partir d'une seule base de code. VisioForge propose une prise en charge complète des applications MAUI via le paquet NuGet VisioForge.DotNet.Core.UI.MAUI (espace de noms : VisioForge.Core.UI.MAUI), qui contient des contrôles d'interface utilisateur spécialement conçus pour la plateforme .NET MAUI.

Nos SDK apportent de puissantes capacités multimédias sur toutes les plateformes prises en charge par MAUI :

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

Vous cherchez un tutoriel concret ?

Une fois les paquets installés, suivez le Guide du lecteur vidéo .NET MAUI — une implémentation complète de VideoView + MediaPlayerCoreX avec sélecteur de fichiers, recherche et volume, qui fonctionne sur iOS, Android, macOS et Windows à partir d'une seule base de code.

Prise en main¶

Installation¶

Pour commencer à utiliser VisioForge avec votre projet MAUI, installez les paquets NuGet requis :

Le paquet SDK correspondant au produit utilisé - l'un des suivants :
VisioForge.DotNet.VideoCapture - capture caméra, écran et caméra IP (VideoCaptureCoreX)
VisioForge.DotNet.MediaPlayer - lecture de fichiers et de flux réseau (MediaPlayerCoreX)
VisioForge.DotNet.VideoEdit - montage sur timeline et rendu (VideoEditCoreX)
VisioForge.DotNet.MediaBlocks - pipelines personnalisés (MediaBlocksPipeline)
Le paquet d'interface utilisateur principal : VisioForge.DotNet.Core.UI.MAUI - le contrôle VideoView
Le redistribuable spécifique à la plateforme (détaillé dans les sections par plateforme ci-dessous)

<ItemGroup>
  <!-- Remplacez par le paquet SDK utilisé par votre application. -->
  <PackageReference Include="VisioForge.DotNet.MediaPlayer" Version="2026.*" />
  <PackageReference Include="VisioForge.DotNet.Core.UI.MAUI" Version="2026.*" />
</ItemGroup>

VisioForge.DotNet.Core.UI.MAUI ne fournit que le contrôle VideoView. À lui seul, il ne peut pas compiler VideoCaptureCoreX, MediaPlayerCoreX ni VideoEditCoreX - c'est le paquet SDK ci-dessus qui les apporte.

Initialisation du SDK¶

Une initialisation correcte est essentielle pour que les SDK VisioForge fonctionnent correctement au sein de votre application MAUI. Ce processus doit être effectué dans votre fichier MauiProgram.cs.

using SkiaSharp.Views.Maui.Controls.Hosting;
using VisioForge.Core.UI.MAUI;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
          .UseMauiApp<App>()
          // Initialiser le paquet SkiaSharp en ajoutant la ligne de code ci-dessous
          .UseSkiaSharp()
          // Initialiser le paquet VisioForge MAUI en ajoutant la ligne de code ci-dessous
          .ConfigureMauiHandlers(handlers => handlers.AddVisioForgeHandlers())
          // Après avoir initialisé le paquet VisioForge MAUI, vous pouvez éventuellement ajouter des polices supplémentaires
          .ConfigureFonts(fonts =>
          {
              fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
              fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
          });

        // Continuez à initialiser votre application .NET MAUI ici
        return builder.Build();
    }
}

AddVisioForgeHandlers enregistre le handler du VideoView. Il ne charge pas le stack natif - c'est un appel distinct, qui doit s'exécuter avant la construction du premier VideoCaptureCoreX, MediaPlayerCoreX, VideoEditCoreX ou MediaBlocksPipeline. Sans lui, le constructeur lève une DllNotFoundException sur une machine vierge :

using VisioForge.Core;

// Initialisation asynchrone (recommandée - le premier appel construit le registre GStreamer
// et peut prendre plusieurs centaines de millisecondes, ce qui figerait le thread UI).
await VisioForgeX.InitSDKAsync();

// Ou initialisation synchrone.
VisioForgeX.InitSDK();

Libérez le SDK à la fermeture de la page ou de l'application :

VisioForgeX.DestroySDK();

Utiliser les contrôles VisioForge en XAML¶

Le contrôle VideoView est l'interface principale pour afficher du contenu vidéo dans votre application MAUI. Pour utiliser les contrôles VisioForge dans vos fichiers XAML :

Ajoutez l'espace de noms VisioForge à votre fichier XAML :

xmlns:vf="clr-namespace:VisioForge.Core.UI.MAUI;assembly=VisioForge.Core.UI.MAUI"

Ajoutez le contrôle VideoView à votre disposition :

<vf:VideoView Grid.Row="0"               
                HorizontalOptions="FillAndExpand"
                VerticalOptions="FillAndExpand"
                x:Name="videoView"
                Background="Black"/>

Le contrôle VideoView s'adapte aux capacités de rendu natives de chaque plateforme tout en exposant une API cohérente pour votre code applicatif.

Configuration spécifique à la plateforme¶

Implémentation Android¶

Android nécessite des étapes de configuration supplémentaires pour fonctionner correctement :

1. Ajouter la bibliothèque de bindings Java¶

Le SDK VisioForge s'appuie sur des fonctionnalités natives d'Android qui requièrent une bibliothèque personnalisée de bindings Java :

Clonez la bibliothèque de bindings depuis notre dépôt GitHub
Choisissez le projet de bindings correspondant à la version de .NET que vous ciblez - le dossier fournit un VisioForge.Core.Android.X{N}.csproj par version de .NET prise en charge (par exemple VisioForge.Core.Android.X9.csproj pour .NET 9, VisioForge.Core.Android.X10.csproj pour .NET 10). Si votre version de .NET n'est pas listée, choisissez la plus proche disponible.
Ajoutez la référence à votre fichier projet :

<ItemGroup Condition="$(TargetFramework.Contains('-android'))">
  <ProjectReference Include="..\..\..\AndroidDependency\VisioForge.Core.Android.X10.csproj" />
</ItemGroup>

2. Ajouter le paquet redistribuable Android¶

Incluez le paquet redistribuable spécifique à Android :

<ItemGroup Condition="$(TargetFramework.Contains('-android'))">
  <PackageReference Include="VisioForge.CrossPlatform.Core.Android" Version="2026.*" />
</ItemGroup>

3. Permissions Android¶

Veillez à ce que votre AndroidManifest.xml inclue les permissions nécessaires pour accéder à la caméra, au microphone et au stockage selon les fonctionnalités de votre application. Les permissions couramment requises sont :

android.permission.CAMERA
android.permission.RECORD_AUDIO
android.permission.READ_EXTERNAL_STORAGE
android.permission.WRITE_EXTERNAL_STORAGE

Configuration iOS¶

L'intégration iOS demande moins d'étapes mais comporte quelques considérations importantes :

1. Ajouter le redistribuable iOS¶

Ajoutez le paquet spécifique à iOS à votre projet :

<ItemGroup Condition="$(TargetFramework.Contains('-ios'))">
  <!-- La version du redistribuable iOS est volontairement en retard sur celle du SDK - elle suit
       le rythme de reconstruction de GStreamer-iOS, pas celui du wrapper. Ne l'alignez pas sur
       VisioForge.DotNet.* ; il n'existe pas de version 2026.x sur nuget.org. -->
  <PackageReference Include="VisioForge.CrossPlatform.Core.iOS" Version="2026.9.11" />
</ItemGroup>

2. Notes importantes pour le développement iOS¶

Utilisez des appareils physiques : le SDK requiert des tests sur des appareils iOS physiques plutôt que sur des simulateurs pour bénéficier de toutes les fonctionnalités.
Descriptions de confidentialité : ajoutez les chaînes de description d'usage nécessaires dans votre fichier Info.plist pour l'accès à la caméra et au microphone :
NSCameraUsageDescription
NSMicrophoneUsageDescription
NSLocalNetworkUsageDescription — requis pour joindre un serveur ou un appareil sur le réseau local. Sans cette clé, iOS 14+ bloque silencieusement le trafic LAN (pas de demande, pas d'erreur).

Configuration macOS¶

Pour les applications macOS Catalyst :

1. Accès au réseau local¶

Si votre application se connecte à un serveur ou à un appareil du réseau local, ajoutez NSLocalNetworkUsageDescription à l'Info.plist de Mac Catalyst. Sans cette clé, iOS et Mac Catalyst peuvent bloquer silencieusement le trafic du réseau local sans afficher de demande d'autorisation.

2. Configurer les identifiants de runtime¶

Pour garantir le bon fonctionnement de votre application sur les Mac Intel et Apple Silicon, spécifiez les identifiants de runtime appropriés :

<PropertyGroup Condition="$([MSBuild]::IsOSPlatform('osx')) AND '$([System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture)' == 'X64' AND $(TargetFramework.Contains('-maccatalyst'))">
  <RuntimeIdentifier>maccatalyst-x64</RuntimeIdentifier>
</PropertyGroup>
<PropertyGroup Condition="$([MSBuild]::IsOSPlatform('osx')) AND '$([System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture)' == 'Arm64' AND $(TargetFramework.Contains('-maccatalyst'))">
  <RuntimeIdentifier>maccatalyst-arm64</RuntimeIdentifier>
</PropertyGroup>

3. Activer le trimming¶

Pour des performances optimales sur macOS, activez l'option PublishTrimmed :

<PublishTrimmed Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">true</PublishTrimmed>

Pour des informations plus détaillées sur le déploiement macOS, consultez notre page de documentation macOS.

Configuration Windows¶

Pour les applications Windows, vous devez inclure plusieurs paquets redistribuables :

1. Ajouter les redistribuables Windows de base¶

Incluez les paquets Windows principaux :

<ItemGroup Condition="$(TargetFramework.Contains('-windows'))">
  <PackageReference Include="VisioForge.CrossPlatform.Core.Windows.x64" Version="2026.*" />
</ItemGroup>

2. Ajouter la prise en charge étendue des codecs (optionnel mais recommandé)¶

Pour une prise en charge étendue des formats multimédias, incluez le paquet libAV (FFMPEG) :

<ItemGroup Condition="$(TargetFramework.Contains('-windows'))">
  <PackageReference Include="VisioForge.CrossPlatform.Libav.Windows.x64" Version="2026.*" />
</ItemGroup>

Optimisation des performances¶

Pour des performances optimales sur toutes les plateformes :

Utilisez l'accélération matérielle lorsqu'elle est disponible
Adaptez la résolution vidéo en fonction des capacités de l'appareil cible
Tenez compte des contraintes mémoire des appareils mobiles lors du traitement de fichiers multimédias volumineux

Résolution des problèmes courants¶

Affichage vidéo vide : assurez-vous que les permissions appropriées sont accordées sur les plateformes mobiles
Codecs manquants : vérifiez que tous les paquets redistribuables spécifiques à la plateforme sont correctement installés
Problèmes de performance : vérifiez que l'accélération matérielle est activée lorsqu'elle est disponible
Erreurs de déploiement : confirmez que les identifiants de runtime sont correctement spécifiés pour la plateforme cible

Conclusion¶

Le SDK VisioForge fournit une solution complète pour ajouter de puissantes capacités multimédias à vos applications .NET MAUI. En suivant les instructions de configuration spécifiques à chaque plateforme et les bonnes pratiques décrites dans ce guide, vous pourrez créer des applications multiplateformes riches avec des fonctions vidéo et audio avancées.

Pour des exemples supplémentaires et du code d'exemple, consultez notre dépôt GitHub.

Étapes suivantes¶

Guide du lecteur vidéo .NET MAUI — tutoriel VideoView complet avec recherche, volume et sélecteur de fichiers
Guide du lecteur Avalonia — alternative multiplateforme orientée bureau (inclut Linux)
Guide du lecteur Android — détails de déploiement spécifiques à Android