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`.