API push .NET de Virtual Camera¶

Le paquet NuGet VisioForge.DotNet.VirtualCamera envoie des images vidéo et des échantillons audio depuis votre application .NET directement vers VisioForge Virtual Camera et Virtual Audio Card. Zoom, OBS Studio et les navigateurs voient la caméra comme une webcam ordinaire, et les applications DirectShow voient aussi la Virtual Audio Card comme un microphone. Aucun graphe DirectShow n'est nécessaire de votre côté.

Le paquet ne dépend pas du reste du SDK VisioForge. Il cible .NET Framework 4.7.2, .NET 8 et .NET 10 sous Windows. Ses types se trouvent dans l'espace de noms VisioForge.VirtualCamera : il peut donc être référencé à côté de VisioForge.DotNet.Core, qui contient les mêmes writers dans VisioForge.Core.VirtualCamera.Push. Un fichier qui importe aussi VisioForge.Core.VirtualCamera.Push qualifie VirtualVideoWriter et VirtualAudioWriter, et un fichier qui importe VisioForge.Core qualifie BaseContext ; un alias using convient également.

Installation¶

<PackageReference Include="VisioForge.DotNet.VirtualCamera" Version="[2026.11.6]" />
<!-- The virtual camera and virtual audio card filters -->
<PackageReference Include="VisioForge.DotNet.Core.Redist.VirtualCamera.x64" Version="[2026.11.6]" />

Redist.VirtualCamera.x64 convient quelle que soit l'architecture de votre application : c'est l'application consommatrice qui charge le filtre, et Zoom, OBS et les navigateurs sont en 64 bits (voir plus bas pour les autres consommateurs). Chaque package Redist.VirtualCamera apporte le package Redist.Shared de son architecture, avec les VisioForge_MFP*.dll et VisioForge_MFPX*.dll que chargent ses filtres (et vcomp140.dll en x64). Une application qui n'est pas x64 et appelle PushFrameBgra ou PushFrameBgr24 référence aussi le Redist.Shared de sa propre architecture (.x86 ou .arm64) pour la conversion des couleurs.

Enregistrement des filtres¶

Les filtres source doivent être enregistrés dans COM une fois sur la machine, avec les droits d'administrateur. Le paquet redist les copie dans le dossier de l'application :

using System;
using System.Diagnostics;
using System.IO;

var dir = AppContext.BaseDirectory;
var args = $"/s \"{Path.Combine(dir, "VisioForge_Virtual_Camera_x64.ax")}\" " +
           $"\"{Path.Combine(dir, "VisioForge_Virtual_Audio_Card_x64.ax")}\"";

// Une seule invite UAC pour les deux filtres.
var info = new ProcessStartInfo(Path.Combine(Environment.SystemDirectory, "regsvr32.exe"), args)
{
    UseShellExecute = true,
    Verb = "runas",
};

using (var process = Process.Start(info))
{
    process.WaitForExit();
    if (process.ExitCode != 0)
    {
        throw new InvalidOperationException($"regsvr32 failed with exit code {process.ExitCode}.");
    }
}

L'application consommatrice charge la version du filtre qui correspond à sa propre architecture, quelle que soit celle de l'application qui envoie les images. Les filtres x64 ci-dessus servent Zoom, OBS et les navigateurs 64 bits. Pour les consommateurs 32 bits, enregistrez aussi VisioForge_Virtual_Camera.ax et VisioForge_Virtual_Audio_Card.ax du redist .x86 ; pour les consommateurs ARM64 natifs, VisioForge_Virtual_Camera_arm64.ax et VisioForge_Virtual_Audio_Card_arm64.ax du sous-dossier arm64 que le redist .arm64 crée dans le dossier de l'application.

Un programme d'installation peut enregistrer les mêmes fichiers ; voir Enregistrement des filtres.

Envoi de la vidéo¶

using VisioForge.VirtualCamera;

const int width = 1280, height = 720;

// Le dernier argument est votre clé de licence Virtual Camera SDK ; null affiche la bande TRIAL.
using (var video = new VirtualVideoWriter(width, height, 30, "VideoStream1", null, "YOUR-LICENSE-KEY"))
{
    video.Start();

    // Toutes les 1/30 s : une image BGRA, ligne du haut en premier, stride en octets.
    video.PushFrameBgra(bgraPixels, width * 4);

    video.Stop();
}

VirtualVideoWriter accepte les images dans trois formats :

La largeur doit être paire. PushFrameBgra et PushFrameBgr24 convertissent en YUY2 en natif dans VisioForge_MFPX64.dll (VisioForge_MFPX.dll sur x86, VisioForge_MFPX_ARM64.dll sur ARM64). Chaque envoi renvoie false lorsqu'aucun tampon n'est libre : un consommateur lent perd une image au lieu de bloquer votre thread.

Envoi de l'audio¶

// PCM 48 kHz stéréo 16 bits pour le micro « VisioForge Virtual Audio Card ».
using (var audio = new VirtualAudioWriter(48000, 2, 16, "AudioStream1", null))
{
    audio.Start();

    audio.PushSamples(pcmBytes); // un nombre entier de trames d'échantillons de 4 octets

    audio.Stop();
}

Les horodatages sont calculés à partir du nombre d'octets envoyés : envoyez l'audio au rythme de sa lecture.

Journalisation¶

Les writers reçoivent un BaseContext pour leurs avertissements et erreurs ; avec null, ils vont vers System.Diagnostics.Trace. Pour les rediriger, dérivez de BaseContext et redéfinissez Error et Warning.

Licences¶

Sans clé de licence, la caméra virtuelle dessine une bande TRIAL sur l'image. Passez la clé reçue lors de l'achat de Virtual Camera SDK au constructeur de VirtualVideoWriter ; la clé dans HKEY_LOCAL_MACHINE\SOFTWARE\VisioForge\Virtual Camera SDK\License fonctionne également.

Démo¶

Virtual Camera Push Demo (WPF, C#), dans le dépôt d'exemples du SDK, dessine une image animée avec WPF, l'envoie avec PushFrameBgra, envoie une tonalité de 440 Hz au micro virtuel et enregistre les filtres à l'aide d'un bouton.

Voir aussi¶

• Virtual Camera SDK
• Exemples