Rename foreground service property for clarity

Renamed `AndroidForegroundServiceEnabled` to `IsAndroidForegroundServiceEnabled` across multiple files, including XAML, C#, and shared code. Updated the default value for the foreground service option to true in `MediaElementOptions`. Added unit tests to verify the default behavior and the ability to disable the foreground service setting. These changes improve clarity and maintainability by standardizing the naming convention.

Author: ne0rrmatrix

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

@@ -30,7 +30,7 @@
             <toolkit:MediaElement
                 x:Name="MediaElement"
                 ShouldAutoPlay="True"
-                AndroidForegroundServiceEnabled="True"
+                IsAndroidForegroundServiceEnabled="True"
                 Source="{x:Static constants:StreamingVideoUrls.BuckBunny}"
                 MetadataArtworkUrl="https://lh3.googleusercontent.com/pw/AP1GczNRrebWCJvfdIau1EbsyyYiwAfwHS0JXjbioXvHqEwYIIdCzuLodQCZmA57GADIo5iB3yMMx3t_vsefbfoHwSg0jfUjIXaI83xpiih6d-oT7qD_slR0VgNtfAwJhDBU09kS5V2T5ZML-WWZn8IrjD4J-g=w1792-h1024-s-no-gm"
                 MetadataTitle="Big Buck Bunny"

samples/CommunityToolkit.Maui.Sample/Pages/Views/MediaElement/MediaElementPage.xaml.cs

@@ -250,7 +250,7 @@ void DisplayPopup(object sender, EventArgs e)
 		{
 			AndroidViewType = AndroidViewType.SurfaceView,
 			Source = MediaSource.FromResource("AppleVideo.mp4"),
-			AndroidForegroundServiceEnabled = false,
+			IsAndroidForegroundServiceEnabled = false,
 			HeightRequest = 600,
 			WidthRequest = 600,
 			ShouldAutoPlay = true,

src/CommunityToolkit.Maui.MediaElement/AppBuilderExtensions.shared.cs

@@ -25,7 +25,7 @@ public static MauiAppBuilder UseMauiCommunityToolkitMediaElement(this MauiAppBui
 	{
 		// Update the default MediaElementOptions for MediaElement if Action is not null
 		options?.Invoke(new MediaElementOptions(builder));
-
+		
 		// Perform Handler configuration
 		builder.ConfigureMauiHandlers(h =>
 		{

src/CommunityToolkit.Maui.MediaElement/Handlers/MediaElementHandler.android.cs

@@ -24,7 +24,7 @@ protected override MauiMediaElement CreatePlatformView()
 								VirtualView,
 								Dispatcher.GetForCurrentThread() ?? throw new InvalidOperationException($"{nameof(IDispatcher)} cannot be null"));
 
-		var (_, playerView) = MediaManager.CreatePlatformView(VirtualView.AndroidViewType, VirtualView.AndroidForegroundServiceEnabled);
+		var (_, playerView) = MediaManager.CreatePlatformView(VirtualView.AndroidViewType, VirtualView.IsAndroidForegroundServiceEnabled);
 		return new(Context, playerView);
 	}
 

src/CommunityToolkit.Maui.MediaElement/MediaElement.shared.cs

@@ -228,7 +228,7 @@ internal event EventHandler StopRequested
 	/// <summary>
 	/// Gets or sets whether the Android Foreground Service is enabled.
 	/// </summary>
-	public bool AndroidForegroundServiceEnabled { get; init; } = MediaElementOptions.AndroidForeServiceEnabled;
+	public bool IsAndroidForegroundServiceEnabled { get; init; } = MediaElementOptions.AndroidForegroundServiceEnabled;
 
 	/// <summary>
 	/// Gets or sets whether the media should start playing as soon as it's loaded.

src/CommunityToolkit.Maui.MediaElement/MediaElementOptions.shared.cs

@@ -20,7 +20,7 @@ internal MediaElementOptions(in MauiAppBuilder builder) : this()
 	/// <summary>
 	/// Set Android Foreground Service for MediaElement on construction
 	/// </summary>
-	internal static bool AndroidForeServiceEnabled { get; private set; } = true;
+	internal static bool AndroidForegroundServiceEnabled { get; private set; } = true;
 
 	/// <summary>
 	/// Set Android View type for MediaElement as SurfaceView or TextureView on construction
@@ -31,5 +31,5 @@ internal MediaElementOptions(in MauiAppBuilder builder) : this()
 	/// Set Android Foreground Service for MediaElement on construction
 	/// </summary>
 	/// <param name="androidForegroundServiceEnabled"></param>
-	public void SetDefaultAndroidForegroundService(bool androidForegroundServiceEnabled) => AndroidForeServiceEnabled = androidForegroundServiceEnabled;
+	public void SetDefaultAndroidForegroundService(bool androidForegroundServiceEnabled) => AndroidForegroundServiceEnabled = androidForegroundServiceEnabled;
 }

src/CommunityToolkit.Maui.UnitTests/Extensions/AppBuilderExtensionsTests.cs

@@ -139,5 +139,24 @@ public void UseMauiCommunityToolkitMediaElement_ShouldSetDefaultAndroidViewType(
 
 		MediaElementOptions.DefaultAndroidViewType.Should().Be(AndroidViewType.TextureView);
 	}
+
+	[Fact]
+	public void UseMauiCommunityToolkitMediaElement_ShouldSetAndroidServiceByDefault()
+	{
+		var builder = MauiApp.CreateBuilder();
+		builder.UseMauiCommunityToolkitMediaElement();
+		MediaElementOptions.AndroidForegroundServiceEnabled.Should().Be(true);
+	}
+
+	[Fact]
+	public void UseMauiCommunityToolkitMediaElement_ServiceCanBeDisabled()
+	{
+		var builder = MauiApp.CreateBuilder();
+		builder.UseMauiCommunityToolkitMediaElement(static options =>
+		{
+			options.SetDefaultAndroidForegroundService(false);
+		});
+		MediaElementOptions.AndroidForegroundServiceEnabled.Should().Be(false);
+	}
 }
 #pragma warning restore CA1416