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 証明書の 2 ファイルがメールで届きます。

ライセンスファイルの種類

開発者ライセンス

開発とデバッグで使用します。Developer 証明書にはオンラインアクティベーションが必要です。

リリースライセンス

配布するアプリケーションで使用します。Release 証明書はオフラインで動作し、エンドユーザー環境でのアクティベーションは不要です。

埋め込みライセンスデータ

.NET SDK では、.vflicense データをアプリケーションの埋め込みリソースから読み込んでください。ライセンスファイルをアプリケーションの横に外部ファイルとして配置して配布しないでください。外部ファイルはコピー、置換、公開される可能性があるため、安全な登録モデルではありません。埋め込みライセンスデータが正しい登録モデルです。

  1. 1.適切な .vflicense ファイルを埋め込みリソースとして追加します。開発とランタイムテストには Developer、配布ビルドには Release を使用します
  2. 2.SDK エンジンまたはパイプラインの各インスタンスを作成し、埋め込み証明書をバイト配列に読み込んで、そのインスタンスで 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 エンジンまたはパイプラインの各インスタンスへ適切な証明書を適用します
  • コンパイルのみを行う CI ジョブに証明書は不要です。ランタイムのメディアテストには適切な Developer または Release 証明書が必要です
  • 証明書の再送、アクティベーションの解除、ボリュームライセンス、特別な要件については support@visioforge.com にお問い合わせください

トラブルシューティング

無効な証明書エラー

SDK 製品に対して正しい .vflicense ファイルを使用していることを確認してください。ファイルが変更または破損していないことを確認してください。

アクティベーションまたはデバイスの変更

デバイス変更後に Developer 証明書をアクティベートできない場合は、以前のアクティベーションの解除または証明書の再送をサポートにご依頼ください。

ネットワーク接続エラー

開発者ライセンスはアクティベーションにインターネット接続が必要です。リリースライセンスはオフラインで動作します。アクティベーションが失敗する場合は、ファイアウォール設定を確認してください。

SDK バージョンが対象外

Annual ライセンスは 12 か月の更新期間中に公開された SDK バージョンを対象とします。Lifetime·Team ライセンスには製品の存続期間中のマイナーおよびメジャーアップデートが含まれます。

透かしまたは未登録の通知が引き続き表示される

SDK エンジンまたはパイプラインを作成し、Open、Start、Build の前にそのインスタンスで SetLicenseCertificateAsync(byte[]) を呼び出し、ビルドに適切な Developer または Release 証明書が含まれていることを確認してください。

ヘルプが必要ですか?

ライセンスのアクティベーションで問題が発生した場合は、サポートチームがお手伝いします。