核心原因 #

LibVLCSharp.Avalonia在部分平台（尤其是Linux Wayland环境如Hyprland）默认会用独立系统窗口渲染视频，导致控件分离、焦点异常等问题，本质是渲染后端未启用嵌入模式。

解决方案 #

1. 初始化LibVLC时强制启用嵌入渲染

创建LibVLC实例时添加参数，强制禁用独立窗口渲染，指定嵌入模式：

// Linux Wayland环境（如Hyprland）专属配置
var libVLC = new LibVLC("--video-output=wayland", "--no-x11", "--embedded-video");

// 跨平台通用配置（兼容Windows/Linux/macOS）
var libVLC = new LibVLC("--embedded-video", "--no-video-window");

这些参数会强制LibVLC将视频渲染到宿主窗口的指定区域，而非创建独立窗口。

2. 调整VideoView的XAML配置

确保VideoView布局属性正确，同时解决焦点丢失问题：

<Grid RowDefinitions="Auto, *, Auto">
    <Label Grid.Row="0" HorizontalAlignment="Center">Video Player</Label>

    <vlc:VideoView Grid.Row="1" MediaPlayer="{Binding MediaPlayer}"
                   HorizontalAlignment="Stretch"
                   VerticalAlignment="Stretch"
                   Focusable="False" <!-- 禁止VideoView抢占焦点，解决主窗口失焦问题 -->
                   PointerEntered="VideoViewOnPointerEntered"
                   PointerExited="VideoViewOnPointerExited">
        <Panel Name="ControlsPanel">
            <StackPanel Orientation="Horizontal" VerticalAlignment="Bottom" Background="#900000FF" Spacing="20">
                <Button Command="{Binding Play}" Margin="20">Play</Button>
                <Button Command="{Binding Stop}" Margin="20">Stop</Button>
            </StackPanel>
        </Panel>
    </vlc:VideoView>
</Grid>

3. Wayland环境额外适配

在Hyprland等Wayland compositor下，需确保应用使用Wayland后端运行（而非XWayland兼容模式），可通过环境变量设置：

export GDK_BACKEND=wayland
export QT_QPA_PLATFORM=wayland
export SDL_VIDEODRIVER=wayland

也可在C#代码中提前设置：

Environment.SetEnvironmentVariable("GDK_BACKEND", "wayland");

4. 禁用硬件加速（可选）

若上述方案仍有问题，可尝试禁用硬件加速避免渲染后端冲突：

var mediaPlayer = new MediaPlayer(libVLC)
{
    HwAcceleration = HwAcceleration.Disabled
};

验证效果 #

应用启动后，视频内容会直接嵌入主窗口的VideoView区域，拖动窗口时控件面板不会分离，聚焦按钮等控件时主窗口也不会失焦。

内容的提问来源于stack exchange，提问作者docyoda