Installer les SDK multimédia VisioForge dans Unity¶

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

Ce guide explique comment installer les SDK multimédia VisioForge dans Unity 6. Un seul .unitypackage autonome intègre quatre produits à la fois dans Unity — le pipeline du Media Blocks SDK .NET ainsi que les moteurs de haut niveau Media Player SDK .NET (MediaPlayerCoreX), Video Capture SDK .NET (VideoCaptureCoreX) et Video Edit SDK .NET (VideoEditCoreX). Le paquet regroupe tous les runtimes natifs pris en charge dans un seul fichier — Windows x64, Android, macOS Standalone et iOS Standalone — et permet à Unity de sélectionner le bon selon la plateforme cible (Build Target) lors de la compilation. Vous ne compilez rien depuis le code source, vous n'avez pas besoin de NuGet et il n'y a pas de dépendances externes à installer.

Le paquet cible des assemblies managés netstandard2.1. Pour les projets limités à l'ancienne version Mono de Unity LTS, une version héritée (legacy) net48 exclusivement pour Windows est encore publiée — voir le spoiler en bas de cette page.

Pour découvrir ce qu'il contient et comment l'utiliser, voir Utiliser VisioForge dans Unity — la vue d'ensemble avec le catalogue complet de produits et d'exemples. Pour le raccourci en cinq étapes, voir le Guide rapide.

Prérequis¶

Téléchargement¶

Téléchargez le dernier paquet cumulatif — Windows + Android + macOS + iOS en un fichier :

VisioForge.MediaBlocks.Unity.unitypackage

https://files.visioforge.com/unity/VisioForge.MediaBlocks.Unity.unitypackage

Étape 1 — Créer ou ouvrir un projet Unity¶

Utilisez un projet Unity 6 existant ou créez-en un nouveau (n'importe quel modèle). Gardez la racine du projet sur un chemin NTFS court (voir l'avertissement plus haut).

Étape 2 — Importer le paquet¶

Dans l'Éditeur : Assets → Import Package → Custom Package…, sélectionnez le .unitypackage téléchargé et cliquez sur Import (gardez tous les éléments cochés).

Le paquet ajoute :

Les métadonnées PluginImporter par déclinaison sur chaque fichier natif disent à Unity à quel Build Target chaque binaire appartient — basculer le Build Target dans Build Profiles choisit automatiquement le bon slot au moment du build.

Étape 3 — Appliquer les réglages de projet requis¶

Au premier import, l'assistant de configuration affiche une boîte de dialogue qui demande d'appliquer deux réglages de projet requis. Cliquez sur Apply — les deux sont configurés pour vous.

Ces deux réglages sont obligatoires — le SDK ne fonctionnera pas sans eux :

• Api Compatibility Level = .NET Standard 2.1 — le SDK est livré sous forme d'assemblies netstandard2.1 ; le réglage legacy .NET Framework ne peut pas les charger.
• Disable Domain Reload — le SDK s'initialise une fois par processus et est réutilisé entre les sessions Play/Stop ; avec Domain Reload activé, l'Éditeur peut se bloquer en sortant du mode Play.

Pour les targets mobiles, basculez aussi Scripting Backend sur IL2CPP — Mono n'est pas pris en charge sur Android ou iOS par Unity lui-même. Voir Compilation pour Android et Compilation pour iOS pour les checklists Build Profile par cible.

Étape 4 — Régler les réglages manuellement (seulement si vous avez cliqué sur Skip)¶

Si vous avez cliqué sur Skip, réglez les deux à la main :

1. Api Compatibility Level = .NET Standard 2.1 Edit → Project Settings → Player → Other Settings → Configuration → Api Compatibility Level.

1. Disable Domain Reload Edit → Project Settings → Editor → Enter Play Mode Settings → réglez When entering Play Mode sur une option qui ne recharge pas le domaine — soit Reload Scene only (correspond à ce que fait Apply) soit Do not reload Domain or Scene.

Étape 5 — Exécuter une scène d'exemple¶

Dans la fenêtre Project ouvrez Assets/Scenes/SimplePlayer.unity (double-clic — ne restez pas sur la scène par défaut vide), sélectionnez le GameObject RawImage, réglez son File Path dans l'Inspector et appuyez sur ▶ Play. La vidéo s'affiche dans la vue Game et l'audio joue via le périphérique audio par défaut du système.

Ensuite, lisez les guides d'utilisation :

• Guide rapide — le chemin en cinq étapes de l'import à la lecture.
• Utiliser VisioForge dans Unity — la vue d'ensemble avec le catalogue complet de produits et d'exemples : lecture de fichiers, RTSP / caméra IP, capture webcam et montage sur timeline.

Compilez pour une plateforme cible¶

Le .unitypackage cumulatif contient chaque plateforme prise en charge, mais chaque Build Target a ses propres réglages et pièges. Lisez la page correspondante :

• Compilation pour Windows — x86_64 Éditeur + Standalone Player.
• Compilation pour Android — IL2CPP arm64, permissions AndroidManifest.
• Compilation pour macOS — Universel arm64+x86_64, signature de code.
• Compilation pour iOS — flux d'export Xcode, permissions Info.plist.

Désinstaller ou mettre à jour le paquet¶

Un .unitypackage n'a pas de désinstalleur : retirez les fichiers manuellement.

1. Fermez d'abord l'Éditeur Unity — il verrouille les DLL natives et le cache Library/.
2. Supprimez le contenu VisioForge de Assets/ :
3. Assets/StreamingAssets/VisioForge/ — le runtime natif Windows.
4. Assets/Plugins/Android/libs/arm64-v8a/libgstreamer_android.so, libVisioForge_Core.so et Assets/Plugins/Android/visioforge-gstreamer.aar — le runtime Android.
5. Assets/Plugins/macOS/*.dylib et Assets/Plugins/macOS/ca-certificates.crt — le runtime macOS.
6. Assets/Plugins/iOS/GStreamerX.framework/ et Assets/Plugins/iOS/libVisioForge_Core.a — le runtime iOS.
7. Assets/Plugins/ (avec les sous-dossiers Android/, macOS/, iOS/Managed/) — les assemblies managés, par plateforme.
8. Assets/VisioForge/ — l'assistant de configuration unique et link.xml.
9. Les scripts dans Assets/Scripts/ : les assistants VisioForgeEnvironment.cs et VisioForgeVideoView.cs plus les six scripts d'exemple — MediaBlocksPlayer.cs, RTSPViewerPlayer.cs, MediaPlayerXPlayer.cs, IPCameraXViewer.cs, VideoCaptureXRecorder.cs, VideoEditXRenderer.cs (plus leurs .meta) — conservez vos propres scripts situés dans ce dossier.
10. Les scènes d'exemple dans Assets/Scenes/ : SimplePlayer.unity, RTSPViewer.unity, MediaPlayerX.unity, IPCameraX.unity, VideoCaptureX.unity, VideoEditX.unity.
11. Supprimez le dossier Library/ du projet (à côté de Assets/) pour effacer l'état d'import en cache. Unity le régénère à la prochaine ouverture (le premier lancement est plus lent).

Mise à jour : importez le nouveau .unitypackage par-dessus l'ancien — les GUIDs des plugins managés sont déterministes, donc Unity écrase les assets existants sur place et les références sont préservées. Si vous venez d'un paquet bien plus ancien ou voyez des DLLs dupliquées dans Assets/Plugins/, faites d'abord une suppression propre (étapes ci-dessus), puis importez le nouveau paquet.

Dépannage¶

Pour la référence complète par symptôme, voir Dépannage.

Déclinaison legacy net48 Windows-seulement¶

Foire aux questions¶

Puis-je installer le SDK dans Unity via NuGet ?¶

Non. Unity n'exécute pas la restauration NuGet, et le SDK livre des centaines de fichiers natifs que NuGet ne disposerait pas pour Unity. Le .unitypackage rassemble tout — assemblies managés, runtime natif de chaque plateforme, scripts et scènes — donc vous importez un seul fichier à la place.

Dois-je installer GStreamer ou une autre dépendance système ?¶

Non. Le paquet est entièrement autonome ; tout ce dont le SDK a besoin est à l'intérieur. Une installation GStreamer système sur votre machine n'est pas requise et n'est pas utilisée par le runtime fourni — au contraire, VisioForgeEnvironment.Configure() retire activement tout GStreamer système du chemin de recherche du processus pour éviter un double-init.

Quels SDK VisioForge sont inclus ?¶

Le paquet livre quatre produits depuis une seule surface managée netstandard2.1 : le pipeline du Media Blocks SDK .NET et les moteurs de haut niveau Media Player SDK .NET (MediaPlayerCoreX), Video Capture SDK .NET (VideoCaptureCoreX) et Video Edit SDK .NET (VideoEditCoreX). Chacun livre une ou plusieurs scènes d'exemple prêtes — voir la vue d'ensemble des exemples.

Le même paquet fonctionne-t-il sur Windows ARM64 ?¶

Le runtime natif Windows du paquet est x86_64 seulement — il n'y a pas de build natif ARM64 aujourd'hui. Exécutez-le via émulation x64 seulement à vos propres risques ; un usage en production sur Windows 11 ARM64 n'est pas exercé.

Puis-je ouvrir le même paquet dans l'Éditeur hôte Mac ?¶

Oui — si le paquet a été construit avec -IncludeMacOS. La variante cumulative publiée à files.visioforge.com/unity/ contient toujours la déclinaison macOS. Un paquet Windows-seulement ouvert dans un Éditeur Mac fait apparaître un message clair [VisioForge] Native runtime folder not found at '…' for runtime platform OSXEditor ; voir Démarrage et cycle de vie.

Voir aussi¶

• Utiliser VisioForge dans Unity — vue d'ensemble du fonctionnement de l'intégration
• Guide rapide — chemin en cinq étapes vers une vidéo qui joue
• Démarrage et cycle de vie — ce que font Configure() et InitializeSdk()
• Lire un fichier multimédia dans Unity — l'exemple de lecture de fichiers
• Voir une caméra RTSP dans Unity — l'exemple RTSP
• Capturer une webcam · Monter et rendre — les exemples des moteurs CoreX
• Matrice des plateformes — prise en charge des fonctionnalités par plateforme Unity
• Aperçu du Media Blocks SDK .NET — le catalogue complet de blocs
• Guide d'installation — installez le SDK dans d'autres types de projets .NET