VisioForge

如何注册您购买的产品

按照这些步骤激活您的许可证并解锁所有功能

.NET SDK(Video Capture SDK .NET、Media Player SDK .NET、Video Edit SDK .NET、Media Blocks SDK .NET)

VisioForge .NET SDK 使用基于 .vflicense 文件的证书许可。购买后,您将通过电子邮件收到两个文件:Developer 证书和 Release 证书。

许可证文件类型

开发者许可证

在开发和调试期间使用。Developer 证书需要在线激活。

发布许可证

在分发的应用程序中使用。Release 证书可离线工作,不需要在最终用户系统上激活。

嵌入许可证数据

对于 .NET SDK,请从应用程序的嵌入资源加载 .vflicense 数据。不要将许可证文件作为外部文件放在应用程序旁边一起部署;外部文件可能被复制、替换或暴露,因此这不是安全的注册模型。嵌入许可证数据才是正确的注册模型。

  1. 1.将适当的 .vflicense 文件添加为嵌入资源:开发和运行时测试使用 Developer,分发版本使用 Release
  2. 2.创建每个 SDK 引擎或 pipeline 实例,将嵌入的证书加载到字节数组中,然后在该实例上调用 SetLicenseCertificateAsync(byte[])
  3. 3.在 Open、Start 或 Build 前调用 SetLicenseCertificateAsync(byte[])。请保护嵌入资源免遭泄露;如需更换证书,请联系支持团队。

C# — 嵌入许可证资源

C#

创建 SDK 实例,从嵌入资源加载适当的 .vflicense 字节,并在 Open、Start 或 Build 前调用 SetLicenseCertificateAsync(byte[])。

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.

安装 SDK

SDK 可以从产品页面下载或通过 NuGet 安装。在 nuget.org 上搜索 VisioForge 软件包。

Delphi 组件

对于 Delphi 应用程序,请使用控件的 SetLicenseKey 方法,该方法将您的许可证密钥作为参数。在 OnCreate/OnLoad 事件中或在调用 Start/Play 方法之前的任何其他位置调用此方法。

  1. 1.在购买确认电子邮件中找到您的许可证密钥
  2. 2.在主窗体的 OnCreate 事件或应用程序初始化中
  3. 3.在使用 Start/Play 方法之前调用 SetLicenseKey 方法
  4. 4.编译并运行您的应用程序以验证许可证是否处于活动状态

Delphi 许可证注册

Delphi

ActiveX 控件

使用 ActiveX 控件或包装类的 SetLicenseKey 方法。

  1. 1.在购买确认电子邮件中找到您的许可证密钥
  2. 2.在您的应用程序中调用 SetLicenseKey 方法
  3. 3.许可证将被自动验证

ActiveX/VB 许可证注册

VB.NET

DirectShow 过滤器

每个 DirectShow SDK 都包含一个自定义 IVFRegister 接口,可用于在应用程序代码中应用您的许可证密钥。Virtual Camera SDK 可选地允许使用注册表进行注册。

  1. 1.在购买确认电子邮件中找到您的许可证密钥
  2. 2.在您的应用程序代码中使用 IVFRegister 接口应用许可证
  3. 3.对于 Virtual Camera SDK,您也可以使用基于注册表的注册

DirectShow 过滤器注册

C++

重要说明

  • 每次购买 .NET 产品都会通过电子邮件提供 Developer 和 Release .vflicense 文件
  • Developer 证书需要在线激活;Release 证书可在最终用户系统上离线工作
  • 在 Open、Start 或 Build 前,将适当的证书应用到每个 SDK 引擎或 pipeline 实例
  • 仅编译的 CI 作业不需要证书;运行时媒体测试需要适当的 Developer 或 Release 证书
  • 如需重发证书、停用激活、批量许可或满足特殊要求,请联系 support@visioforge.com

故障排除

无效证书错误

验证您使用的是与您的 SDK 产品匹配的正确 .vflicense 文件。确保文件未被修改或损坏。

激活或更换设备

如果更换设备后无法激活 Developer 证书,请联系支持团队停用以前的激活或重发证书。

网络连接错误

开发者许可证需要互联网连接进行激活。发布许可证可离线工作。如果激活失败,请检查您的防火墙设置。

SDK 版本未覆盖

Annual 许可证涵盖其 12 个月更新期内发布的 SDK 版本。Lifetime·Team 许可证包含产品生命周期内的次要和主要更新。

仍显示水印或未注册提示

创建 SDK 引擎或 pipeline,在 Open、Start 或 Build 前在该实例上调用 SetLicenseCertificateAsync(byte[]),并确认构建中包含适当的 Developer 或 Release 证书。

需要帮助?

如果您在许可证激活方面遇到问题,我们的支持团队随时为您提供帮助。