Enhance service lifecycle and exit strategy (#2039)

* Enhance service lifecycle and exit strategy

- Updated `AndroidManifest.xml` to improve `CommunityToolkit.Maui.Media.Services` behavior. Added `android:stopWithTask=true` and `android:foregroundServiceType=mediaPlayback` attributes to ensure the service stops with the task and properly manages media playback in the foreground.
- Added `OnDestroy()` method in `MediaControlsService.android.cs` for a more aggressive shutdown approach. This includes logging service destruction, stopping and removing the service from the foreground, finishing and removing the task, exiting the application, and ensuring base class cleanup with `base.OnDestroy()`. This aims at a cleaner exit and resource management when the service is destroyed.

* Fix Merge error

---------

Co-authored-by: Brandon Minnick <[email protected]>
Co-authored-by: Gerald Versluis <[email protected]>

Author: 3 people

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

@@ -2,7 +2,7 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
     <application android:allowBackup="true" android:icon="@mipmap/appicon" android:enableOnBackInvokedCallback="true"
                  android:supportsRtl="true">
-        <service android:name="communityToolkit.maui.media.services" android:exported="false" android:enabled="true"
+        <service android:name="communityToolkit.maui.media.services" android:stopWithTask="true" android:exported="false" android:enabled="true"
                  android:foregroundServiceType="mediaPlayback">
             <intent-filter>
                 <action android:name="android.intent.action.MEDIA_BUTTON"/>

src/CommunityToolkit.Maui.MediaElement/Services/MediaControlsService.android.cs

@@ -217,6 +217,15 @@ void OnSetIntents()
 		notification?.AddAction(actionNext);
 	}
 
+	public override void OnDestroy()
+	{
+		Platform.CurrentActivity?.StopService(new Intent(Platform.AppContext, typeof(MediaControlsService)));
+		System.Diagnostics.Trace.TraceInformation("MediaControlsService destroyed.");
+		Platform.CurrentActivity?.FinishAndRemoveTask();
+		System.Environment.Exit(0);
+		System.Diagnostics.Trace.TraceInformation("Application exiting.");
+		base.OnDestroy();
+	}
 	static void BroadcastUpdate(string receiver, string action)
 	{
 		if (Build.VERSION.SdkInt >= BuildVersionCodes.Tiramisu)