media-player-sdk-x-winui

Integrate VisioForge Media Player SDK X playback into WinUI 3 apps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the integration and deployment headaches of adding VisioForge Media Player SDK X playback to a WinUI 3 (Windows App SDK) app, including the correct WinUI VideoView wiring, pinned NuGet setup, and common runtime failures.

Core Features & Use Cases

  • WinUI 3 VideoView integration: Render X-engine playback by wiring the WinUI-specific VideoView to a Win2D CanvasControl.
  • Cross-platform X SDK playback setup: Configure MediaPlayerCoreX with the right wrapper and native redist NuGets and use UniversalSourceSettings.CreateAsync to open URIs/paths/streams.
  • Production-focused troubleshooting: Address frequent issues like DLL not found (native resolution), missing codecs/elements, trial expiration due to missing license certificate, and black preview symptoms.
  • Audio device handling & basic controls: Select an audio output device, enable/disable audio playback, and support play/pause/resume/stop and seeking with UI timers.

Quick Start

Add the pinned NuGets, create a VideoView(canvasControl), construct MediaPlayerCoreX with it, then open a source with UniversalSourceSettings.CreateAsync and call OpenAsync followed by PlayAsync.

Frequently Asked Questions about media-player-sdk-x-winui

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

FAQPage Schema
How do I integrate media playback into a WinUI 3 application?

To integrate media playback in WinUI 3, wire a WinUI-specific VideoView to a Win2D CanvasControl, construct MediaPlayerCoreX with it, and open sources using UniversalSourceSettings.CreateAsync. This setup supports local files and streaming protocols like HTTP, HLS, DASH, RTSP, and RTMP.

Why does my WinUI 3 media player show a black preview screen?

A black preview screen in WinUI 3 media playback often results from incorrect VideoView wiring or native DLL resolution failures. Ensure the WinUI-specific wrapper is correctly attached to the Win2D CanvasControl and that pinned native redist NuGet packages are properly configured for deployment.

Can I deploy a WinUI 3 media player app using MSIX packaging?

Yes, WinUI 3 media player apps using MediaPlayerCoreX support both MSIX and unpackaged deployment. Correct deployment requires using pinned versions of the wrapper and native redist NuGets to ensure native DLLs and codecs resolve correctly at runtime without missing file errors.

How do I fix missing codec errors when playing video files in WinUI 3?

Missing codec errors during WinUI 3 media playback usually occur when native dependencies are not properly resolved. Install the required native redist NuGets with pinned versions alongside the MediaPlayerCoreX wrapper to ensure the necessary GStreamer elements and codecs are loaded for your media containers.

Does MediaPlayerCoreX support audio output device selection and seeking?

Yes, MediaPlayerCoreX supports audio output device selection, enabling or disabling audio, and basic playback controls including play, pause, resume, stop, and seeking. You can implement seeking and UI updates using timers within your WinUI 3 application.

Why does my VisioForge media player SDK trial expire immediately in WinUI 3?

Immediate trial expiration in WinUI 3 happens when the license certificate is not loaded. You must optionally load the license certificate bytes per MediaPlayerCoreX instance during initialization to validate your SDK license and prevent trial expiration errors.