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 엔진 또는 파이프라인 인스턴스를 생성하고 내장 인증서를 바이트 배열로 로드한 다음 해당 인스턴스에서 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 인증서가 포함되었는지 확인하세요.

도움이 필요하신가요?

라이선스 활성화에 문제가 있는 경우 지원 팀이 도와드리겠습니다.