Aller au contenu

Guide de déploiement de Media Player SDK .NET

Try it Download Windows trial dotnet add package VisioForge.DotNet.MediaPlayer Pricing →

Media Player SDK .NET

Ce guide complet couvre tous les scénarios de déploiement pour le Media Player SDK .NET, garantissant que vos applications fonctionnent correctement dans différents environnements. Que vous développiez des applications multiplateformes ou des solutions spécifiques à Windows, ce guide fournit les étapes nécessaires à un déploiement réussi.

Vue d'ensemble des types de moteur

Le Media Player SDK .NET offre deux types principaux de moteur, chacun conçu pour des scénarios de déploiement spécifiques :

Moteur MediaPlayerCoreX (multiplateforme)

MediaPlayerCoreX est notre solution multiplateforme qui fonctionne sur plusieurs systèmes d'exploitation. Pour des instructions de déploiement détaillées propres à ce moteur, consultez le Guide de déploiement multiplateforme principal.

Moteur MediaPlayerCore (Windows uniquement)

Le moteur MediaPlayerCore est optimisé spécifiquement pour les environnements Windows. Lors du déploiement d'applications qui utilisent ce moteur sur des ordinateurs sans le SDK préinstallé, vous devez inclure les composants SDK nécessaires avec votre application.

Important : pour les applications AnyCPU, vous devez déployer à la fois les redistribuables x86 et x64 pour garantir la compatibilité entre les différentes architectures système.

Options de déploiement

Il existe trois méthodes principales pour déployer les composants Media Player SDK .NET :

  1. Utilisation des paquets NuGet (recommandé pour la plupart des scénarios)
  2. Utilisation des programmes d'installation silencieux automatiques (nécessite des privilèges administratifs)
  3. Installation manuelle (pour un contrôle total du processus de déploiement)

Déploiement par paquets NuGet

Les paquets NuGet fournissent la méthode de déploiement la plus simple, gérant automatiquement l'inclusion des fichiers nécessaires dans le dossier de votre application durant le processus de build.

Paquets NuGet requis

Paquets principaux (toujours requis)

Paquets propres aux fonctionnalités (ajouter selon les besoins)

Prise en charge des formats multimédias
Prise en charge des sources
Prise en charge des formats audio
Prise en charge des filtres

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. LAV est la valeur par défaut de Source_Mode dans MediaPlayerCore : une application MediaPlayerCore exécutée en tant que processus ARM64 ne peut donc pas lire de fichier. Les applications AnyCPU s'y exécutent généralement aussi en ARM64. Sous Windows ARM64, définissez Source_Mode sur MediaPlayerSourceMode.File_VLC et ajoutez le paquet VLC ARM64 (la lecture fonctionne, mais les filtres VisioForge qui n'ont pas encore de version ARM64, comme YUV2RGB, déclenchent encore OnError), utilisez MediaPlayerCoreX ou Media Blocks SDK .NET, ou compilez l'application pour x64 (PlatformTarget défini sur x64 ; elle s'exécute alors en émulation).

Programmes d'installation silencieux automatiques

Pour les scénarios où vous préférez un déploiement basé sur un installeur, le SDK propose des installeurs silencieux automatiques qui nécessitent des privilèges administratifs.

Installeurs disponibles

Composants principaux

Prise en charge des formats multimédias

Prise en charge des sources

Prise en charge des formats audio

Prise en charge des filtres

Note : pour désinstaller un paquet installé, exécutez l'exécutable avec des privilèges administratifs en utilisant les paramètres : /x //

Installation manuelle

Pour les scénarios de déploiement avancés nécessitant un contrôle précis de l'installation des composants, suivez ces étapes :

Étape 1 : Dépendances runtime

  • Avec privilèges administratifs : installez le runtime VC++ 2022 (v143) (x86/x64) et les DLL runtime OpenMP à l'aide d'exécutables redistribuables ou de modules MSM.
  • Sans privilèges administratifs : copiez le runtime VC++ 2022 (v143) (x86/x64) et les DLL runtime OpenMP directement dans le dossier de votre application.

Étape 2 : Composants principaux

  • Copiez les DLL VisioForge_MFP/VisioForge_MFPX (ou versions x64) depuis le répertoire Redist\Filters dans le dossier de votre application.

Étape 3 : Assemblies .NET

  • Copiez les assemblies .NET dans le dossier de votre application ou installez-les dans le Global Assembly Cache (GAC).

Étape 4 : Filtres DirectShow

  • Copiez et enregistrez via COM les filtres DirectShow du SDK en utilisant regsvr32.exe ou une autre méthode appropriée.

Étape 5 : Configuration de l'environnement

  • Ajoutez le dossier contenant les filtres à la variable d'environnement système PATH si votre exécutable d'application se trouve dans un répertoire différent.

Configuration des filtres DirectShow

Le SDK utilise divers filtres DirectShow pour des fonctionnalités spécifiques. Voici une liste complète organisée par catégorie de fonctionnalité :

Filtres de fonctionnalités de base

  • VisioForge_Video_Effects_Pro.ax
  • VisioForge_MP3_Splitter.ax
  • VisioForge_H264_Decoder.ax
  • VisioForge_Audio_Mixer.ax

Filtres d'effets audio

  • VisioForge_Audio_Effects_4.ax (effets audio hérités)

Filtres de prise en charge du streaming

Streaming RTSP

  • VisioForge_RTSP_Sink.ax
  • Filtres MP4 (hérités/modernes, hors multiplexeur)

Streaming SSF

  • VisioForge_SSF_Muxer.ax
  • Filtres MP4 (hérités/modernes, hors multiplexeur)

Filtres source

Source VLC

  • VisioForge_VLC_Source.ax
  • Dossier complet Redist\VLC avec enregistrement COM
  • Variable d'environnement VLC_PLUGIN_PATH pointant vers le dossier VLC\plugins

Source FFMPEG

  • VisioForge_FFMPEG_Source.ax
  • Dossier complet Redist\FFMPEG, ajouté à la variable PATH de Windows

Source mémoire

  • VisioForge_AsyncEx.ax

Décodage WebM

  • VisioForge_WebM_Ogg_Source.ax
  • VisioForge_WebM_Source.ax
  • VisioForge_WebM_Split.ax
  • VisioForge_WebM_Vorbis_Decoder.ax
  • VisioForge_WebM_VP8_Decoder.ax
  • VisioForge_WebM_VP9_Decoder.ax

Sources de streaming réseau

  • VisioForge_RTSP_Source.ax
  • VisioForge_RTSP_Source_Live555.ax
  • Filtres FFMPEG, VLC ou LAV

Sources de format audio

  • VisioForge_Xiph_FLAC_Source.ax (source FLAC)
  • VisioForge_Xiph_Ogg_Demux2.ax (source Ogg Vorbis)
  • VisioForge_Xiph_Vorbis_Decoder.ax (source Ogg Vorbis)

Filtres de fonctionnalités spéciales

Chiffrement vidéo

  • VisioForge_Encryptor_v8.ax
  • VisioForge_Encryptor_v9.ax

Accélération GPU

  • VisioForge_DXP.dll / VisioForge_DXP64.dll (effets vidéo GPU DirectX 11)

Source LAV

  • Contenu complet de redist\LAV\x86(x64), avec tous les fichiers .ax enregistrés

Astuce pour l'enregistrement des filtres

Pour simplifier le processus d'enregistrement COM de tous les filtres DirectShow d'un répertoire, placez le fichier « reg_special.exe » du redist du SDK dans le dossier des filtres et exécutez-le avec des privilèges administratifs.

Pour plus d'exemples de code, visitez notre dépôt GitHub.