video-capture-sdk-x-macos

Integrate VisioForge Video Capture SDK X into .NET macOS AppKit apps.

Updated May 29, 2025
One-click install
npx skills add https://github.com/visioforge/help --skill video-capture-sdk-x-macos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: video-capture-sdk-x-macos
Source: https://github.com/visioforge/help/tree/main/dotnet/agent-skills/video-capture-sdk-x-macos
Command: npx skills add https://github.com/visioforge/help --skill video-capture-sdk-x-macos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of integrating VisioForge Video Capture SDK X into a native .NET for macOS app, including the macOS-specific setup that commonly causes silent failures, missing permissions, or black previews.

Core Features & Use Cases

  • Native .NET for macOS (AppKit) capture wiring: Integrates the cross-platform X engine (VideoCaptureCoreX) with the macOS UI host (NSView via VideoViewGL), targeting net10.0-macos.
  • macOS privacy + permissions correctness: Ensures the required Info.plist usage keys (camera/microphone) and triggers the permission prompt via AVCaptureDevice.RequestAccessForMediaType.
  • Hardened runtime / entitlements troubleshooting: Documents the entitlements needed for camera/microphone/USB devices so access is not denied silently in signed builds.
  • Licensing + trial-mode behavior: Covers loading the .vflicense certificate bytes before StartAsync and avoiding trial expiry issues tied to instance lifecycle.
  • Common production failure recovery: Addresses native redist inclusion (VisioForge.CrossPlatform.Core.macOS), fat binaries (arm64 + x64), and main-thread initialization to prevent frozen/black frames.

Quick Start

Use this skill to set up a new net10.0-macos native AppKit project by copying the bundled references, wiring VideoViewGL into your Storyboard host view, and then calling StartAsync after AVCaptureDevice.RequestAccessForMediaType has been invoked.

Frequently Asked Questions about video-capture-sdk-x-macos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate webcam capture into a native .NET macOS AppKit application?▼

To integrate webcam capture into a native .NET macOS AppKit app, wire the cross-platform `VideoCaptureCoreX` engine to an `NSView` using `VideoViewGL`, then invoke `StartAsync` after requesting device permissions via `AVCaptureDevice.RequestAccessForMediaType`.

Why does my .NET macOS camera preview show a black screen?▼

Black camera previews in .NET macOS apps often result from missing native redist packages like `VisioForge.CrossPlatform.Core.macOS`, incorrect fat binaries, or failing to initialize the SDK on the main thread.

What Info.plist keys are required for camera and microphone access in macOS .NET apps?▼

macOS .NET apps require mandatory camera and microphone usage-description keys in `Info.plist` to trigger permission prompts via `AVCaptureDevice.RequestAccessForMediaType` and avoid silent access failures.

Do I need hardened runtime entitlements for USB and IP camera capture on macOS?▼

Yes, signed macOS builds require hardened-runtime entitlements for camera, microphone, and USB devices to prevent silent permission denials during webcam, USB UVC, or IP camera capture.

How do I configure VisioForge SDK licensing to avoid trial mode issues in .NET macOS?▼

To avoid trial mode issues in .NET macOS, load the `.vflicense` certificate bytes before calling `StartAsync` and properly manage the `VideoCaptureCoreX` instance lifecycle to prevent trial expiry.

Can I use VideoCaptureCoreX for NDI and screen recording in a net10.0-macos project?▼

Yes, `VideoCaptureCoreX` supports NDI, screen, IP camera, and webcam capture recording scenarios in a `net10.0-macos` project by hosting the rendering in an `NSView`.