VisioForge

Comment enregistrer votre produit acheté

Suivez ces étapes pour activer votre licence et débloquer toutes les fonctionnalités

SDKs .NET (Video Capture SDK .NET, Media Player SDK .NET, Video Edit SDK .NET, Media Blocks SDK .NET)

Les SDKs .NET VisioForge utilisent un système de licence basé sur des fichiers .vflicense. Après l'achat, vous recevez deux fichiers par e-mail : un certificat Developer et un certificat Release.

Types de fichiers de licence

Licence Développeur

Utilisez ce certificat pendant le développement et le débogage. Le certificat Developer nécessite une activation en ligne.

Licence Release

Utilisez ce certificat dans les applications distribuées. Le certificat Release fonctionne hors ligne et ne nécessite aucune activation sur les systèmes des utilisateurs finaux.

Données de licence intégrées

Pour les SDKs .NET, chargez les données .vflicense depuis une ressource intégrée de l'application. Ne déployez pas les fichiers de licence comme fichiers externes à côté de votre app ; les fichiers externes peuvent être copiés, remplacés ou exposés, ce qui n'est pas un modèle d'enregistrement sûr. Les données de licence intégrées constituent le modèle d'enregistrement correct.

  1. 1.Ajoutez le fichier .vflicense approprié comme ressource intégrée : Developer pour le développement et les tests d'exécution, Release pour les builds distribués
  2. 2.Créez chaque instance de moteur ou de pipeline SDK, chargez le certificat intégré dans un tableau d'octets et appelez SetLicenseCertificateAsync(byte[]) sur cette instance
  3. 3.Appelez SetLicenseCertificateAsync(byte[]) avant Open, Start ou Build. Protégez la ressource intégrée contre toute divulgation et contactez le support si vous avez besoin d'un certificat de remplacement.

C# — Ressource de licence intégrée

C#

Créez l'instance SDK, chargez les octets .vflicense appropriés depuis une ressource intégrée et appelez SetLicenseCertificateAsync(byte[]) avant Open, Start ou Build.

using System.IO;
using System.Reflection;

// Use the Developer certificate in development and the Release certificate in distributed builds.
#if DEBUG
const string licenseResourceName = "MyApp.Licenses.MediaBlocksSDK-Developer.vflicense";
#else
const string licenseResourceName = "MyApp.Licenses.MediaBlocksSDK-Release.vflicense";
#endif

// Load the certificate into a byte array from an embedded resource.
using var resourceStream = Assembly.GetExecutingAssembly()
    .GetManifestResourceStream(licenseResourceName)
    ?? throw new InvalidOperationException("License resource not found");
using var ms = new MemoryStream();
await resourceStream.CopyToAsync(ms);

byte[] licenseData = ms.ToArray();

// Create each SDK instance first, then apply its certificate before Open, Start, or Build.
var pipeline = new MediaBlocksPipeline();
await pipeline.SetLicenseCertificateAsync(licenseData);

// Add and connect the required media blocks, then start the licensed pipeline.

Installation du SDK

Le SDK peut être téléchargé depuis la page du produit ou installé via NuGet. Recherchez les packages VisioForge sur nuget.org.

Composants Delphi

Pour les applications Delphi, utilisez la méthode SetLicenseKey du contrôle, qui prend votre clé de licence comme paramètre. Appelez cette méthode dans les événements OnCreate/OnLoad ou n'importe où ailleurs avant l'appel de la méthode Start/Play.

  1. 1.Trouvez votre clé de licence dans l'email de confirmation d'achat
  2. 2.Dans l'événement OnCreate de votre formulaire principal ou l'initialisation de l'application
  3. 3.Appelez la méthode SetLicenseKey avant d'utiliser les méthodes Start/Play
  4. 4.Compilez et exécutez votre application pour vérifier que la licence est active

Enregistrement de licence Delphi

Delphi

Contrôles ActiveX

Utilisez la méthode SetLicenseKey du contrôle ActiveX ou de la classe wrapper.

  1. 1.Trouvez votre clé de licence dans l'email de confirmation d'achat
  2. 2.Appelez la méthode SetLicenseKey dans votre application
  3. 3.La licence sera validée automatiquement

Enregistrement de licence ActiveX/VB

VB.NET

Filtres DirectShow

Chaque SDK DirectShow contient une interface IVFRegister personnalisée qui peut être utilisée pour appliquer votre clé de licence dans le code de l'application. Virtual Camera SDK permet éventuellement l'enregistrement à l'aide du registre.

  1. 1.Trouvez votre clé de licence dans l'email de confirmation d'achat
  2. 2.Utilisez l'interface IVFRegister dans le code de votre application pour appliquer la licence
  3. 3.Pour Virtual Camera SDK, vous pouvez alternativement utiliser l'enregistrement basé sur le registre

Enregistrement de filtres DirectShow

C++

Remarques importantes

  • Chaque achat .NET comprend des fichiers .vflicense Developer et Release envoyés par e-mail
  • Les certificats Developer nécessitent une activation en ligne ; les certificats Release fonctionnent hors ligne sur les systèmes des utilisateurs finaux
  • Appliquez le certificat approprié à chaque instance de moteur ou de pipeline SDK avant Open, Start ou Build
  • Les tâches CI qui compilent uniquement n'ont pas besoin de certificat ; les tests multimédias à l'exécution nécessitent le certificat Developer ou Release approprié
  • Contactez support@visioforge.com pour le renvoi d'un certificat, la désactivation d'une activation, les licences en volume ou les besoins particuliers

Dépannage

Erreur de certificat invalide

Vérifiez que vous utilisez le bon fichier .vflicense pour votre produit SDK. Assurez-vous que le fichier n'a pas été modifié ou corrompu.

Activation ou changement d'appareil

Si un certificat Developer ne peut pas être activé après un changement d'appareil, contactez le support pour désactiver l'ancienne activation ou faire renvoyer le certificat.

Erreur de connexion réseau

Les licences développeur nécessitent une connexion internet pour l'activation. Les licences release fonctionnent hors ligne. Vérifiez les paramètres de votre pare-feu si l'activation échoue.

Version SDK non couverte

Une licence Annual couvre les versions du SDK publiées pendant ses 12 mois de mises à jour. Une licence Lifetime·Team inclut les mises à jour mineures et majeures pendant toute la durée de vie du produit.

Le filigrane ou l'avis de produit non enregistré apparaît toujours

Créez le moteur ou le pipeline SDK, appelez SetLicenseCertificateAsync(byte[]) sur cette instance avant Open, Start ou Build et vérifiez que le build contient le certificat Developer ou Release approprié.

Besoin d'aide ?

Si vous rencontrez des problèmes lors de l'activation de la licence, notre équipe de support est prête à vous aider.