Lock Screen Controls and Metadata Support for Windows, Android, IOS and Mac Catalyst

samples/CommunityToolkit.Maui.Sample/CommunityToolkit.Maui.Sample.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
     <TargetFrameworks>$(NetVersion)-ios;$(NetVersion)-android;$(NetVersion)-maccatalyst</TargetFrameworks>

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

@@ -31,13 +31,15 @@
                 x:Name="MediaElement"
                 ShouldAutoPlay="True"
                 Source="https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"
+                MetaDataArtworkUrl="https://lh3.googleusercontent.com/pw/AP1GczNRrebWCJvfdIau1EbsyyYiwAfwHS0JXjbioXvHqEwYIIdCzuLodQCZmA57GADIo5iB3yMMx3t_vsefbfoHwSg0jfUjIXaI83xpiih6d-oT7qD_slR0VgNtfAwJhDBU09kS5V2T5ZML-WWZn8IrjD4J-g=w1792-h1024-s-no-gm"
+                MetaDataTitle="Big Buck Bunny"
+                MetaDataArtist="Blender Foundation"
                 MediaEnded="OnMediaEnded"
                 MediaFailed="OnMediaFailed"
                 MediaOpened="OnMediaOpened"
                 PositionChanged="OnPositionChanged"
                 StateChanged="OnStateChanged"
                 SeekCompleted="OnSeekCompleted"/>
-
             <HorizontalStackLayout Grid.Row="1" Padding="0,0,0,15">
                 <Label HorizontalOptions="Center">
                     <Label.Text>

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

@@ -1,4 +1,5 @@
 using System.ComponentModel;
+using CommunityToolkit.Maui.Core;
 using CommunityToolkit.Maui.Core.Primitives;
 using CommunityToolkit.Maui.Sample.ViewModels.Views;
 using CommunityToolkit.Maui.Views;
@@ -159,22 +160,35 @@ async void ChangeSourceClicked(Object sender, EventArgs e)
 		switch (result)
 		{
 			case loadOnlineMp4:
+				MediaElement.MetaDataTitle = "Big Buck Bunny";
+				MediaElement.MetaDataArtworkUrl = "https://lh3.googleusercontent.com/pw/AP1GczNRrebWCJvfdIau1EbsyyYiwAfwHS0JXjbioXvHqEwYIIdCzuLodQCZmA57GADIo5iB3yMMx3t_vsefbfoHwSg0jfUjIXaI83xpiih6d-oT7qD_slR0VgNtfAwJhDBU09kS5V2T5ZML-WWZn8IrjD4J-g=w1792-h1024-s-no-gm";
+				MediaElement.MetaDataArtist = "Big Buck Bunny Album";
 				MediaElement.Source =
 					MediaSource.FromUri(
 						"https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4");
 				return;
 
 			case loadHls:
+				MediaElement.MetaDataArtist = "HLS Album";
+				MediaElement.MetaDataArtworkUrl = "https://lh3.googleusercontent.com/pw/AP1GczNRrebWCJvfdIau1EbsyyYiwAfwHS0JXjbioXvHqEwYIIdCzuLodQCZmA57GADIo5iB3yMMx3t_vsefbfoHwSg0jfUjIXaI83xpiih6d-oT7qD_slR0VgNtfAwJhDBU09kS5V2T5ZML-WWZn8IrjD4J-g=w1792-h1024-s-no-gm";
+				MediaElement.MetaDataTitle = "HLS Title";
 				MediaElement.Source
 					= MediaSource.FromUri(
 						"https://mtoczko.github.io/hls-test-streams/test-gap/playlist.m3u8");
 				return;
 
 			case resetSource:
+				MediaElement.MetaDataArtworkUrl = string.Empty;
+				MediaElement.MetaDataTitle = string.Empty;
+				MediaElement.MetaDataArtist = string.Empty;
 				MediaElement.Source = null;
 				return;
 
 			case loadLocalResource:
+				MediaElement.MetaDataArtworkUrl = "https://lh3.googleusercontent.com/pw/AP1GczNRrebWCJvfdIau1EbsyyYiwAfwHS0JXjbioXvHqEwYIIdCzuLodQCZmA57GADIo5iB3yMMx3t_vsefbfoHwSg0jfUjIXaI83xpiih6d-oT7qD_slR0VgNtfAwJhDBU09kS5V2T5ZML-WWZn8IrjD4J-g=w1792-h1024-s-no-gm";
+				MediaElement.MetaDataTitle = "Local Resource Title";
+				MediaElement.MetaDataArtist = "Local Resource Album";
+
 				if (DeviceInfo.Platform == DevicePlatform.MacCatalyst
 					|| DeviceInfo.Platform == DevicePlatform.iOS)
 				{

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

@@ -1,16 +1,29 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
-	<application android:allowBackup="true" android:icon="@mipmap/appicon" android:roundIcon="@mipmap/appicon_round" android:supportsRtl="true" />
+	<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" android:foregroundServiceType="mediaPlayback">
+      <intent-filter>
+        <action android:name="android.intent.action.MEDIA_BUTTON" />
+      </intent-filter>
+      <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" />
-
-	<uses-permission android:name="android.permission.RECORD_AUDIO" />
-	<queries>
+	<uses-permission android:name="com.sec.android.provider.badge.permission.READ" />
+	<uses-permission android:name="com.sec.android.provider.badge.permission.WRITE" />
+	
+  <uses-permission android:name="android.permission.RECORD_AUDIO" />
+		<queries>
 		<intent>
 			<action android:name="android.intent.action.TTS_SERVICE" />
 		</intent>

samples/CommunityToolkit.Maui.Sample/Platforms/MacCatalyst/Info.plist

@@ -28,7 +28,21 @@
 	<string>Assets.xcassets/appicon.appiconset</string>
 	<key>NSSpeechRecognitionUsageDescription</key>
 	<string>ISpeechToText Uses Speech Recognition</string>
+	<key>NSLocalNetworkUsageDescription</key>
+	<string></string>
 	<key>NSMicrophoneUsageDescription</key>
 	<string>ISpeechToText Uses Microphone</string>
+	<key>NSAppTransportSecurity</key>
+	<dict>
+		<key>NSAllowsArbitraryLoadsInMedia</key>
+		<true/>
+		<key>NSAllowsArbitraryLoads</key>
+		<true/>
+	</dict>
+	<key>UIBackgroundModes</key>
+	<array>
+		<string>bluetooth-central</string>
+		<string>audio</string>
+	</array>
 </dict>
 </plist>

samples/CommunityToolkit.Maui.Sample/Platforms/iOS/Info.plist

@@ -34,5 +34,14 @@
 	<string>ISpeechToText Uses Speech Recognition</string>
 	<key>NSMicrophoneUsageDescription</key>
 	<string>ISpeechToText Uses Microphone</string>
+	<key>NSAppTransportSecurity</key>
+	<dict>
+		<key>NSAllowsArbitraryLoadsInMedia</key>
+		<true/>
+	</dict>
+	<key>UIBackgroundModes</key>
+	<array>
+		<string>audio</string>
+	</array>
 </dict>
 </plist>

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

@@ -1,4 +1,8 @@
-using CommunityToolkit.Maui.Core.Handlers;
+#if ANDROID
+using CommunityToolkit.Maui.Media.Services;
+#endif
+
+using CommunityToolkit.Maui.Core.Handlers;
 using CommunityToolkit.Maui.Views;
 
 namespace CommunityToolkit.Maui;
@@ -19,7 +23,9 @@ public static MauiAppBuilder UseMauiCommunityToolkitMediaElement(this MauiAppBui
 		{
 			h.AddHandler<MediaElement, MediaElementHandler>();
 		});
-
+#if ANDROID
+		builder.Services.AddSingleton<MediaControlsService>();
+#endif
 		return builder;
 	}
 }

src/CommunityToolkit.Maui.MediaElement/CommunityToolkit.Maui.MediaElement.csproj

@@ -61,6 +61,7 @@
   <ItemGroup Condition="$(TargetFramework.Contains('-android'))">
     <PackageReference Include="Xam.Plugins.Android.ExoPlayer" Version="[2.19.1,)"/>
     <PackageReference Include="Xam.Plugins.Android.ExoPlayer.Transformer" Version="[2.19.1,)"/>
+    <PackageReference Include="Xam.Plugins.Android.ExoPlayer.MediaSession" Version="2.19.1"/>
   </ItemGroup>
 
   <ItemGroup>

src/CommunityToolkit.Maui.MediaElement/Extensions/AndroidMediaPermissions.android.cs

@@ -0,0 +1,18 @@
+using static Microsoft.Maui.ApplicationModel.Permissions;
+
+namespace CommunityToolkit.Maui.Extensions;
+sealed class AndroidMediaPermissions : BasePlatformPermission
+{
+
+	static readonly (string androidPermission, bool isRuntime)[] permissions = [
+#if ANDROID28_0_OR_GREATER
+			(global::Android.Manifest.Permission.ForegroundService, true),
+#endif
+#if ANDROID33_0_OR_GREATER
+			(global::Android.Manifest.Permission.PostNotifications, true),
+#endif
+		];
+
+	public override (string androidPermission, bool isRuntime)[] RequiredPermissions => permissions;
+
+}