如何注册您购买的产品
按照这些步骤激活您的许可证并解锁所有功能
.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.将适当的 .vflicense 文件添加为嵌入资源:开发和运行时测试使用 Developer,分发版本使用 Release
- 2.创建每个 SDK 引擎或 pipeline 实例,将嵌入的证书加载到字节数组中,然后在该实例上调用 SetLicenseCertificateAsync(byte[])
- 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.在购买确认电子邮件中找到您的许可证密钥
- 2.在主窗体的 OnCreate 事件或应用程序初始化中
- 3.在使用 Start/Play 方法之前调用 SetLicenseKey 方法
- 4.编译并运行您的应用程序以验证许可证是否处于活动状态
Delphi 许可证注册
DelphiActiveX 控件
使用 ActiveX 控件或包装类的 SetLicenseKey 方法。
- 1.在购买确认电子邮件中找到您的许可证密钥
- 2.在您的应用程序中调用 SetLicenseKey 方法
- 3.许可证将被自动验证
ActiveX/VB 许可证注册
VB.NETDirectShow 过滤器
每个 DirectShow SDK 都包含一个自定义 IVFRegister 接口,可用于在应用程序代码中应用您的许可证密钥。Virtual Camera SDK 可选地允许使用注册表进行注册。
- 1.在购买确认电子邮件中找到您的许可证密钥
- 2.在您的应用程序代码中使用 IVFRegister 接口应用许可证
- 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 证书。
