VisioForge

How to Register Your Purchased Product

Follow these steps to activate your license and unlock all features

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

VisioForge .NET SDKs use certificate-based licensing with .vflicense files. After purchase, you receive two files by email: a Developer certificate and a Release certificate.

License File Types

Developer License

Use during development and debugging. The Developer certificate requires online activation.

Release License

Use in distributed applications. The Release certificate works offline and does not require activation on end-user systems.

Embedded License Data

For .NET SDKs, load the .vflicense data from an embedded application resource. Do not deploy license files as external files beside your app; external files can be copied, replaced, or exposed, so this is not a secure registration model. Embedded license data is the correct registration model.

  1. 1.Add the appropriate .vflicense file as an embedded resource: Developer for development and runtime tests, Release for distributed builds
  2. 2.Construct each SDK engine or pipeline instance, load the embedded certificate into a byte array, and call SetLicenseCertificateAsync(byte[]) on that instance
  3. 3.Call SetLicenseCertificateAsync(byte[]) before Open, Start, or Build. Protect the embedded resource against disclosure; contact support if you need a replacement certificate.

C# — Embedded License Resource

C#

Create the SDK instance, load the appropriate .vflicense bytes from an embedded resource, and call SetLicenseCertificateAsync(byte[]) before Open, Start, or 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.

Installing the SDK

The SDK can be downloaded from the product page or installed via NuGet. Search for VisioForge packages on nuget.org.

Delphi Components

For Delphi applications, use the SetLicenseKey method of control, which takes your license key as a parameter. Call this method in OnCreate/OnLoad events or anywhere else before the Start/Play method call.

  1. 1.Find your license key in the purchase confirmation email
  2. 2.In your main form's OnCreate event or application initialization
  3. 3.Call the SetLicenseKey method before using Start/Play methods
  4. 4.Compile and run your application to verify the license is active

Delphi License Registration

Delphi

ActiveX Controls

Use the SetLicenseKey method of ActiveX control or wrapper class.

  1. 1.Find your license key in the purchase confirmation email
  2. 2.Call the SetLicenseKey method in your application
  3. 3.The license will be validated automatically

ActiveX/VB License Registration

VB.NET

DirectShow Filters

Each DirectShow SDK contains a custom IVFRegister interface that can be used to apply your license key in the app code. Virtual Camera SDK optionally allows registration using the registry.

  1. 1.Find your license key in the purchase confirmation email
  2. 2.Use the IVFRegister interface in your application code to apply the license
  3. 3.For Virtual Camera SDK, you can alternatively use registry-based registration

DirectShow Filter Registration

C++

Important Notes

  • Each .NET purchase includes Developer and Release .vflicense files delivered by email
  • Developer certificates require online activation; Release certificates work offline on end-user systems
  • Apply the appropriate certificate to every SDK engine or pipeline instance before Open, Start, or Build
  • Compile-only CI jobs do not need a certificate; runtime media tests need the appropriate Developer or Release certificate
  • Contact support@visioforge.com for certificate resends, activation deactivation, volume licensing, or special requirements

Troubleshooting

Invalid Certificate Error

Verify you are using the correct .vflicense file for your SDK product. Ensure the file has not been modified or corrupted.

Activation or Device Change

If a Developer certificate cannot be activated after a device change, contact support to deactivate the previous activation or resend the certificate.

Network Connection Error

Developer licenses require an internet connection for activation. Release licenses work offline. Check your firewall settings if activation fails.

SDK Version Not Covered

An Annual license covers SDK versions released during its 12-month update period. A Lifetime·Team license includes minor and major updates for the product lifetime.

Watermark or Unregistered Notice Still Appears

Create the SDK engine or pipeline, call SetLicenseCertificateAsync(byte[]) on that instance before Open, Start, or Build, and verify that the build contains the appropriate Developer or Release certificate.

Need Help?

If you're experiencing issues with license activation, our support team is ready to assist.

Email SupportJoin Discord