Add stream media source

.github/instructions/codestyle.instructions.md

@@ -235,6 +235,28 @@ This guide provides a set of best practices and coding standards for writing C#
 	}
 	```
 
+## Argument Validation:
+
+- Prefer `ArgumentNullException.ThrowIfNull` over manual null checks:
+	```csharp
+	// Good: Concise null validation
+	public void Write(byte[] buffer)
+	{
+		ArgumentNullException.ThrowIfNull(buffer);
+		// Use buffer safely here
+	}
+
+	// Avoid: Verbose manual null check
+	public void Write(byte[] buffer)
+	{
+		if (buffer is null)
+		{
+			throw new ArgumentNullException(nameof(buffer));
+		}
+		// Use buffer safely here
+	}
+	```
+
 ## Safe Operations:
 
 - Use Try methods for safer operations:
@@ -578,4 +600,4 @@ Here Key Components of the Try Pattern:
 4. Null Analysis Attribute: [NotNullWhen(true)] (or [MaybeNullWhen(false)]) informs the compiler that if the method returns true, the out parameter is guaranteed to be non-null. 
 
 This pattern allows for high-performance retrieval or parsing without throwing exceptions for expected failures. It also allows cleaner call sites by eliminating the need for null-checking the output variable within the if block, as seen in Dictionary<TKey, TValue>.TryGetValue. 
-```
+

samples/CommunityToolkit.Maui.Sample/AppShell.xaml.cs

@@ -125,6 +125,7 @@ public partial class AppShell : Shell
 		CreateViewModelMapping<LazyViewPage, LazyViewViewModel, ViewsGalleryPage, ViewsGalleryViewModel>(),
 		CreateViewModelMapping<MapsPinsPage, MapsPinsViewModel, ViewsGalleryPage, ViewsGalleryViewModel>(),
 		CreateViewModelMapping<MediaElementPage, MediaElementViewModel, ViewsGalleryPage, ViewsGalleryViewModel>(),
+		CreateViewModelMapping<MediaElementFromStreamPage, MediaElementFromStreamViewModel, ViewsGalleryPage, ViewsGalleryViewModel>(),
 		CreateViewModelMapping<MediaElementCarouselViewPage, MediaElementCarouselViewViewModel, ViewsGalleryPage, ViewsGalleryViewModel>(),
 		CreateViewModelMapping<MediaElementCollectionViewPage, MediaElementCollectionViewViewModel, ViewsGalleryPage, ViewsGalleryViewModel>(),
 		CreateViewModelMapping<MediaElementMultipleWindowsPage, MediaElementMultipleWindowsViewModel, ViewsGalleryPage, ViewsGalleryViewModel>(),

samples/CommunityToolkit.Maui.Sample/MauiProgram.cs

@@ -123,6 +123,9 @@ public static MauiApp CreateMauiApp()
 		builder.Services.AddHttpClient<ByteArrayToImageSourceConverterViewModel>()
 						.AddStandardResilienceHandler(static options => options.Retry = new MobileHttpRetryStrategyOptions());
 
+		builder.Services.AddHttpClient<MediaElementFromStreamPage>()
+			.AddStandardResilienceHandler(static options => options.Retry = new MobileHttpRetryStrategyOptions());
+
 		builder.Services.AddSingleton<AppShell>();
 
 		RegisterViewsAndViewModels(builder.Services);
@@ -252,6 +255,7 @@ static void RegisterViewsAndViewModels(in IServiceCollection services)
 		services.AddTransientWithShellRoute<LazyViewPage, LazyViewViewModel>();
 		services.AddTransientWithShellRoute<MapsPinsPage, MapsPinsViewModel>();
 		services.AddTransientWithShellRoute<MediaElementPage, MediaElementViewModel>();
+		services.AddTransientWithShellRoute<MediaElementFromStreamPage, MediaElementFromStreamViewModel>();
 		services.AddTransientWithShellRoute<MediaElementCarouselViewPage, MediaElementCarouselViewViewModel>();
 		services.AddTransientWithShellRoute<MediaElementCollectionViewPage, MediaElementCollectionViewViewModel>();
 		services.AddTransientWithShellRoute<MediaElementMultipleWindowsPage, MediaElementMultipleWindowsViewModel>();

samples/CommunityToolkit.Maui.Sample/Pages/Views/MediaElement/MediaElementFromStreamPage.xaml

@@ -0,0 +1,160 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<pages:BasePage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+             xmlns:pages="clr-namespace:CommunityToolkit.Maui.Sample.Pages"
+             xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
+             xmlns:constants="clr-namespace:CommunityToolkit.Maui.Sample.Constants"
+             xmlns:viewModels="clr-namespace:CommunityToolkit.Maui.Sample.ViewModels.Views"
+             xmlns:converters="clr-namespace:CommunityToolkit.Maui.Sample.Converters"
+             x:TypeArguments="viewModels:MediaElementFromStreamViewModel"
+             x:DataType="viewModels:MediaElementFromStreamViewModel"
+             x:Class="CommunityToolkit.Maui.Sample.Pages.Views.MediaElementFromStreamPage"
+             Title="MediaElement">
+    <pages:BasePage.Resources>
+        <converters:SecondsToStringConverter x:Key="SecondsToStringConverter" />
+    </pages:BasePage.Resources>
+
+    <ScrollView>
+        <Grid>
+            <Grid.RowDefinitions>
+                <RowDefinition Height="220" />
+                <RowDefinition Height="50" />
+                <RowDefinition Height="Auto" />
+                <RowDefinition Height="Auto" />
+                <RowDefinition Height="Auto" />
+                <RowDefinition Height="Auto" />
+                <RowDefinition Height="Auto" />
+                <RowDefinition Height="Auto" />
+                <RowDefinition Height="Auto" />
+            </Grid.RowDefinitions>
+            <toolkit:MediaElement
+                x:Name="MediaElement"
+                ShouldAutoPlay="True"
+                MediaEnded="OnMediaEnded"
+                MediaFailed="OnMediaFailed"
+                MediaOpened="OnMediaOpened"
+                PositionChanged="OnPositionChanged"
+                StateChanged="OnStateChanged"
+                SeekCompleted="OnSeekCompleted"/>
+            <HorizontalStackLayout Grid.Row="1" Padding="0,0,0,15">
+                <Label HorizontalOptions="Center" x:DataType="toolkit:MediaElement">
+                    <Label.Text>
+                        <MultiBinding StringFormat="{}Current State: {0} - Dimensions: {1}x{2}">
+                            <Binding Path="CurrentState" Source="{x:Reference MediaElement}" />
+                            <Binding Path="MediaWidth" Source="{x:Reference MediaElement}" />
+                            <Binding Path="MediaHeight" Source="{x:Reference MediaElement}" />
+                        </MultiBinding>
+                    </Label.Text>
+                </Label>
+
+            </HorizontalStackLayout>
+
+            <Grid Grid.Row="2" Padding="0,10,0,10" ColumnDefinitions="*,*,*,*" ColumnSpacing="5">
+                <Button Grid.Column="0" Text="Play" Clicked="OnPlayClicked" />
+                <Button Grid.Column="1" Text="Pause" Clicked="OnPauseClicked" />
+                <Button Grid.Column="2" Text="Stop" Clicked="OnStopClicked" />
+                <Button Grid.Column="3" Text="Mute" Clicked="OnMuteClicked">
+                    <Button.Triggers>
+                        <DataTrigger TargetType="Button"
+                                     x:DataType="toolkit:MediaElement"
+                                     Binding="{Binding ShouldMute, Source={x:Reference MediaElement}}"
+                                     Value="True">
+                            <Setter Property="Text" Value="Unmute" />
+                        </DataTrigger>
+                        <DataTrigger TargetType="Button"
+                                     x:DataType="toolkit:MediaElement"
+                                     Binding="{Binding ShouldMute, Source={x:Reference MediaElement}}"
+                                     Value="False">
+                            <Setter Property="Text" Value="Mute" />
+                        </DataTrigger>
+                    </Button.Triggers>
+                </Button>
+            </Grid>
+
+            <Slider
+                x:Name="PositionSlider"
+                Grid.Row="3"
+                MinimumTrackColor="Gray"
+                DragStarted="Slider_DragStarted"
+                DragCompleted="Slider_DragCompleted"/>
+
+            <Grid Grid.Row="4" HorizontalOptions="Fill">
+                <Label HorizontalOptions="Start" x:DataType="toolkit:MediaElement" Text="{Binding Position, Source={x:Reference MediaElement}, Converter={StaticResource SecondsToStringConverter}}" />
+                <Label HorizontalOptions="End" HorizontalTextAlignment="End" x:DataType="toolkit:MediaElement" Text="{Binding Duration, Source={x:Reference MediaElement}, Converter={StaticResource SecondsToStringConverter}}" />
+            </Grid>
+
+            <VerticalStackLayout Padding="0,20,0,0" Grid.Row="5" Spacing="5">
+                <HorizontalStackLayout Spacing="5" HorizontalOptions="Center">
+                    <Button Text="Open Video" Clicked="OnOpenVideoClicked" HorizontalOptions="Fill" />
+
+                    <Button Text="Record Video" Clicked="OnRecordVideoClicked" HorizontalOptions="Fill" />
+                </HorizontalStackLayout>
+                <Button Text="Change Aspect" Clicked="ChangeAspectClicked" />
+            </VerticalStackLayout>
+
+            <HorizontalStackLayout Grid.Row="6" Padding="0,10,0,10" Spacing="5">
+                <Label Margin="20,10" x:DataType="toolkit:MediaElement">
+                    <Label.FormattedText>
+                        <FormattedString>
+                            <Span Text="Speed:" />
+                            <Span Text="{Binding Source={x:Reference MediaElement}, Path=Speed}" />
+                        </FormattedString>
+                    </Label.FormattedText>
+                </Label>
+
+                <Button Text="-" Clicked="OnSpeedMinusClicked" />
+                <Button Text="+" Clicked="OnSpeedPlusClicked" />
+            </HorizontalStackLayout>
+
+            <HorizontalStackLayout Grid.Row="7" Padding="0,10,0,10" Spacing="5">
+                <Label Margin="20,10" x:DataType="toolkit:MediaElement">
+                    <Label.FormattedText>
+                        <FormattedString>
+                            <Span Text="Volume:" />
+                            <Span Text="{Binding Source={x:Reference MediaElement}, Path=Volume, StringFormat='{}{0:P0}'}" />
+                        </FormattedString>
+                    </Label.FormattedText>
+                </Label>
+
+                <Button Text="-" Clicked="OnVolumeMinusClicked" />
+                <Button Text="+" Clicked="OnVolumePlusClicked" />
+            </HorizontalStackLayout>
+
+            <VerticalStackLayout Grid.Row="8">
+                <HorizontalStackLayout Padding="0,0,0,10">
+                    <Switch
+                        Margin="0,0,5,0"
+                        ThumbColor="White"
+                        OnColor="LimeGreen"
+                        x:DataType="toolkit:MediaElement"
+                        IsToggled="{Binding Source={x:Reference MediaElement}, Path=ShouldShowPlaybackControls}" />
+                    <Label
+                        VerticalOptions="Center"
+                        Text="Show playback controls" />
+                </HorizontalStackLayout>
+                <HorizontalStackLayout Padding="0,0,0,10">
+                    <Switch
+                        Margin="0,0,5,0"
+                        ThumbColor="White"
+                        OnColor="LimeGreen"
+                        x:DataType="toolkit:MediaElement"
+                        IsToggled="{Binding Source={x:Reference MediaElement}, Path=ShouldLoopPlayback}" />
+                    <Label
+                        VerticalOptions="Center"
+                        Text="Loop media" />
+                </HorizontalStackLayout>
+                <HorizontalStackLayout>
+                    <Switch
+                        Margin="0,0,5,0"
+                        ThumbColor="White"
+                        OnColor="LimeGreen"
+                        x:DataType="toolkit:MediaElement"
+                        IsToggled="{Binding Source={x:Reference MediaElement}, Path=ShouldKeepScreenOn}" />
+                    <Label
+                        VerticalOptions="Center"
+                        Text="Keep screen on" />
+                </HorizontalStackLayout>
+            </VerticalStackLayout>
+        </Grid>
+    </ScrollView>
+</pages:BasePage>