Add the MediaPlayer package to your project

dotnet add package Avalonia.Controls.MediaPlayer

Add the default theme to your App.axaml

<Application.Styles>
    <FluentTheme/>

    <!-- Add this declaration for the default theme. -->
    <MediaFluentTheme/>
</Application.Styles>

Include your Avalonia UI license key in the executable project file .csproj

<ItemGroup>
    <AvaloniaUILicenseKey Include="YOUR_LICENSE_KEY" />
</ItemGroup>

Using MediaPlayerControl (recommended)

<Window xmlns="https://github.com/avaloniaui"
        Width="800" Height="450">

    <MediaPlayerControl Name="mediaPlayer"
                        Source="{Binding MediaSource}"
                        Volume="0.8"/>

</Window>

Using MediaPlayer directly

// Create and initialize a MediaPlayer
var player = new MediaPlayer();
await player.InitializeAsync();

// Set properties
player.Volume = 0.8;
player.LoadedBehavior = MediaPlayerState.AutoPlay;

// Load and play media
player.Source = new UriSource("https://example.com/audio.mp3");
await player.PrepareAsync();
await player.PlayAsync();

No. This component is part of the Avalonia Pro and Enterprise tiers. Activation requires an Avalonia account and a valid Pro or Enterprise licence.

Yes. Each component gives you a ready UI out of the box, but you can build a bespoke interface by using the underlying classes directly and wiring up your own commands and visuals.

Supported formats depend on the underlying platform. Check the component's documentation and the platform's own capability lists for specifics.

Avalonia UI components support Windows, macOS, Linux, iOS, Android, and WebAssembly. Each component uses the native platform back-end for optimal performance and compatibility.