Skip to content

README.md

Latest commit

 

History

History
55 lines (36 loc) · 2.13 KB

README.md

File metadata and controls

55 lines (36 loc) · 2.13 KB

LibVLCSharp.Avalonia

The official Avalonia views for LibVLCSharp.

This package contains the views that allows to display a video played with LibVLCSharp in an Avalonia app.

This package depends on LibVLCSharp as well as Avalonia.

Supported frameworks:

  • netstandard2.0

Supported platforms:

  • Windows
  • MacOS
  • Linux

Airspace limitations

If you encounter UI issues with the Avalonia VideoView in your application, you may be running into what is called airspace limitations.

For context and explanations of the tradeoffs, see this PR. This is about WPF, but the same applies to Avalonia because they are really close in terms of architecture. Issues related to airspace are tracked on our GitLab with the airspace tag.

Avalonia control specific stuffs

Due to the Airspace issue, you cannot easily draw things over the video, unless you have a hack like the one that is included in this project. This hack means that the Avalonia control works a little differently than other platform's.

If you want to place something over the control, you would probably write code like this in other platforms:

<Grid>
    <vlc:VideoView x:Name="VideoView" />
    <Button Click="Play_Clicked">PLAY</Button>
</Grid>

But for Avalonia, you would rather need something like this:

<Grid>
    <vlc:VideoView x:Name="VideoView">
        <Button Click="Play_Clicked">PLAY</Button>
    </vlc:VideoView>
</Grid>

The VideoView appears as a container in your XAML (you can set its Content property from code too), but it is really a detached window over your video control.

The DataContext of the VideoView is propagated to your overlay content. This means you can inherit the DataContext environment from the outside of your VideoView

*Note : This behavior is specific to the LibVLCSharp Avalonia and WPF implementations