Add support to make AndroidForegroundService optional to MediaElement

samples/CommunityToolkit.Maui.Sample/MauiProgram.cs

@@ -72,6 +72,7 @@ public static MauiApp CreateMauiApp()
 								.UseMauiCommunityToolkitMediaElement(static options =>
 								{
 									options.SetDefaultAndroidViewType(AndroidViewType.TextureView);
+									options.SetDefaultAndroidForegroundService(true);
 								})
 								.ConfigureMauiHandlers(static handlers =>
 								{

samples/CommunityToolkit.Maui.Sample/Platforms/Android/AndroidManifest.xml

@@ -4,12 +4,23 @@
                  android:supportsRtl="true">
 
       <meta-data android:name="com.google.android.geo.API_KEY" android:value="PASTE-YOUR-API-KEY-HERE" />
+
+      <service android:name="communityToolkit.maui.media.services" android:stopWithTask="true" android:exported="false" android:enabled="true"
+                android:foregroundServiceType="mediaPlayback">
+        <intent-filter>
+          <action android:name="androidx.media3.session.MediaSessionService"/>
+        </intent-filter>
+      </service>
     </application>
 
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
     <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
 
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"/>
+    <uses-permission android:name="android.permission.MEDIA_CONTENT_CONTROL"/>
     <!-- Samsung -->
     <uses-permission android:name="com.sec.android.provider.badge.permission.READ"/>
     <uses-permission android:name="com.sec.android.provider.badge.permission.WRITE"/>

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

@@ -25,7 +25,7 @@
 	{
 		// Update the default MediaElementOptions for MediaElement if Action is not null
 		options?.Invoke(new MediaElementOptions(builder));
-
+		
 		// Perform Handler configuration
 		builder.ConfigureMauiHandlers(h =>
 		{
@@ -33,7 +33,7 @@
 		});
 
 #if ANDROID
 		builder.Services.AddSingleton<Media.Services.MediaControlsService>();
 #endif
 
 		return builder;

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);
+		var (_, playerView) = MediaManager.CreatePlatformView(VirtualView.AndroidViewType, VirtualView.IsAndroidForegroundServiceEnabled);
 		return new(Context, playerView);
 	}
 

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

@@ -225,6 +225,8 @@ internal event EventHandler StopRequested
 	/// </summary>
 	public AndroidViewType AndroidViewType { get; init; } = MediaElementOptions.DefaultAndroidViewType;
 
+	internal bool IsAndroidForegroundServiceEnabled { get; init; } = MediaElementOptions.IsAndroidForegroundServiceEnabled;
+
 	/// <summary>
 	/// Gets or sets whether the media should start playing as soon as it's loaded.
 	/// Default is <see langword="false"/>. This is a bindable property.

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

@@ -22,8 +22,19 @@ internal MediaElementOptions(in MauiAppBuilder builder) : this()
 	/// </summary>
 	internal static AndroidViewType DefaultAndroidViewType { get; private set; } = AndroidViewType.SurfaceView;
 
+	/// <summary>
+	/// Set Android Foreground Service for MediaElement on construction
+	/// </summary>
+	internal static bool IsAndroidForegroundServiceEnabled { get; private set; } = true;
+
 	/// <summary>
 	/// Set Android View type for MediaElement as SurfaceView or TextureView on construction
 	/// </summary>
 	public void SetDefaultAndroidViewType(AndroidViewType androidViewType) => DefaultAndroidViewType = androidViewType;
+
+	/// <summary>
+	/// Set Android Foreground Service for MediaElement on construction
+	/// </summary>
+	/// <param name="androidForegroundServiceEnabled">Specifies whether the Android Foreground Service should be enabled for the MediaElement. Set to <c>true</c> to enable, or <c>false</c> to disable.</param>
+	public void SetDefaultAndroidForegroundService(bool androidForegroundServiceEnabled) => IsAndroidForegroundServiceEnabled = androidForegroundServiceEnabled;
 }

src/CommunityToolkit.Maui.MediaElement/Views/MauiMediaElement.android.cs

@@ -8,11 +8,6 @@
 using AndroidX.Media3.UI;
 using CommunityToolkit.Maui.Views;
 
-[assembly: UsesPermission(Android.Manifest.Permission.ForegroundServiceMediaPlayback)]
-[assembly: UsesPermission(Android.Manifest.Permission.ForegroundService)]
-[assembly: UsesPermission(Android.Manifest.Permission.MediaContentControl)]
-[assembly: UsesPermission(Android.Manifest.Permission.PostNotifications)]
-
 namespace CommunityToolkit.Maui.Core.Views;
 
 /// <summary>

src/CommunityToolkit.Maui.MediaElement/Views/MediaManager.android.cs

@@ -21,6 +21,7 @@ namespace CommunityToolkit.Maui.Core.Views;
 
 public partial class MediaManager : Java.Lang.Object, IPlayerListener
 {
+	bool androidForegroundServiceEnabled;
 	const int bufferState = 2;
 	const int readyState = 3;
 	const int endedState = 4;
@@ -130,11 +131,11 @@ or PlaybackState.StateSkippingToQueueItem
 	/// <returns>The platform native counterpart of <see cref="MediaElement"/>.</returns>
 	/// <exception cref="NullReferenceException">Thrown when <see cref="Context"/> is <see langword="null"/> or when the platform view could not be created.</exception>
 	[MemberNotNull(nameof(Player), nameof(PlayerView), nameof(session))]
-	public (PlatformMediaElement platformView, PlayerView PlayerView) CreatePlatformView(AndroidViewType androidViewType)
+	public (PlatformMediaElement platformView, PlayerView PlayerView) CreatePlatformView(AndroidViewType androidViewType, bool androidForegroundServiceEnabled)
 	{
 		Player = new ExoPlayerBuilder(MauiContext.Context).Build() ?? throw new InvalidOperationException("Player cannot be null");
 		Player.AddListener(this);
-
+		this.androidForegroundServiceEnabled = androidForegroundServiceEnabled;
 		if (androidViewType is AndroidViewType.SurfaceView)
 		{
 			PlayerView = new PlayerView(MauiContext.Context)
@@ -353,7 +354,7 @@ protected virtual async partial ValueTask PlatformUpdateSource()
 			return;
 		}
 
-		if (connection is null)
+		if (connection is null && androidForegroundServiceEnabled)
 		{
 			StartService();
 		}

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

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