Full screen events

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

@@ -39,7 +39,8 @@
                 MediaOpened="OnMediaOpened"
                 PositionChanged="OnPositionChanged"
                 StateChanged="OnStateChanged"
-                SeekCompleted="OnSeekCompleted"/>
+                SeekCompleted="OnSeekCompleted"
+                ScreenStateChanged="MediaElement_FullScreenStateChanged"/>
             <HorizontalStackLayout Grid.Row="1" Padding="0,0,0,15">
                 <Label HorizontalOptions="Center" x:DataType="toolkit:MediaElement">
                     <Label.Text>

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

@@ -35,6 +35,8 @@ public MediaElementPage(MediaElementViewModel viewModel, IFileSystem fileSystem,
 		MediaElement.PropertyChanged += MediaElement_PropertyChanged;
 	}
 
+	void MediaElement_FullScreenStateChanged(object? sender, ScreenStateChangedEventArgs e) =>
+		logger.LogInformation("FullScreen State Changed. Old State: {PreviousState}, New State: {NewState}", e.PreviousState, e.NewState);
 	void MediaElement_PropertyChanged(object? sender, PropertyChangedEventArgs e)
 	{
 		if (e.PropertyName == MediaElement.DurationProperty.PropertyName)

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

@@ -28,8 +28,24 @@ protected override MauiMediaElement CreatePlatformView()
 		return new(Context, playerView);
 	}
 
+	protected override void ConnectHandler(MauiMediaElement platformView)
+	{
+		platformView.FullScreenStateChanged += OnScreenStateChanged;
+		base.ConnectHandler(platformView);
+	}
+
+	void OnScreenStateChanged(object? sender, ScreenStateChangedEventArgs e)
+	{
+		MediaManager?.UpdateFullScreenState(e.NewState);
+	}
+	/// <summary>
+	/// Disconnects the handler from the platform-specific <see cref="MauiMediaElement"/> and
+	/// unsubscribes from related events, disposing the platform view and handler resources.
+	/// </summary>
+	/// <param name="platformView">The platform-specific <see cref="MauiMediaElement"/> instance to disconnect.</param>
 	protected override void DisconnectHandler(MauiMediaElement platformView)
 	{
+		platformView.FullScreenStateChanged -= OnScreenStateChanged;
 		platformView.Dispose();
 		Dispose();
 		base.DisconnectHandler(platformView);

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

@@ -29,9 +29,27 @@ protected override MauiMediaElement CreatePlatformView()
 		return new(mediaPlatform);
 	}
 
+	/// <summary>
+	/// Establishes a connection between the handler and the specified platform-specific media element view.
+	/// </summary>
+	/// <remarks>Overrides the base implementation to provide custom connection logic for the media element on the
+	/// Windows platform.</remarks>
+	/// <param name="platformView">The platform-specific media element view to connect to the handler. Cannot be null.</param>
+	protected override void ConnectHandler(MauiMediaElement platformView)
+	{
+		platformView.FullScreenStateChanged += OnScreenStateChanged;
+		base.ConnectHandler(platformView);
+	}
+
+	void OnScreenStateChanged(object? sender, ScreenStateChangedEventArgs e)
+	{
+		MediaManager?.UpdateFullScreenState(e.NewState);
+	}
+
 	/// <inheritdoc/>
 	protected override void DisconnectHandler(MauiMediaElement platformView)
 	{
+		platformView.FullScreenStateChanged -= OnScreenStateChanged;
 		Dispose();
 		UnloadPlatformView(platformView);
 		base.DisconnectHandler(platformView);

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

@@ -29,6 +29,11 @@ public interface IMediaElement : IView, IAsynchronousMediaElementHandler
 	/// </summary>
 	MediaElementState CurrentState { get; }
 
+	/// <summary>
+	/// Gets the full screen state of the media element.
+	/// </summary>
+	MediaElementScreenState FullScreenState { get; }
+
 	/// <summary>
 	/// Gets the height (in pixels) of the loaded media in pixels.
 	/// </summary>
@@ -111,6 +116,11 @@ public interface IMediaElement : IView, IAsynchronousMediaElementHandler
 	/// </summary>
 	string MetadataArtworkUrl { get; set; }
 
+	/// <summary>
+	/// Occurs when the <see cref="FullScreenState"/> changes.
+	/// </summary>
+	event EventHandler<ScreenStateChangedEventArgs> ScreenStateChanged;
+
 	/// <summary>
 	/// Occurs when the media has ended playing successfully.
 	/// </summary>
@@ -161,4 +171,10 @@ public interface IMediaElement : IView, IAsynchronousMediaElementHandler
 	/// </summary>
 	/// <param name="newState">The new state the <see cref="MediaElement"/> transitioned to.</param>
 	internal void CurrentStateChanged(MediaElementState newState);
+
+	/// <summary>
+	/// Triggers a <see cref="FullScreenState"/> change. Intended to be called by platform-specific handlers or managers when the fullscreen state changes.
+	/// </summary>
+	/// <param name="newState">The new fullscreen state the <see cref="MediaElement"/> transitioned to.</param>
+	internal void FullScreenChanged(MediaElementScreenState newState);
 }

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

@@ -32,8 +32,16 @@ public partial class MediaElement : View, IMediaElement, IDisposable
 	/// </summary>
 	public static readonly BindableProperty DurationProperty = durationPropertyKey.BindableProperty;
 
+	static readonly BindablePropertyKey screenStatePropertyKey =
+		BindableProperty.CreateReadOnly(nameof(FullScreenState), typeof(MediaElementScreenState), typeof(MediaElement),
+			MediaElementScreenState.Default, propertyChanged: OnFullScreenPropertyChanged);
 	/// <summary>
-	/// Bindable property for the <see cref="ShouldAutoPlay"/> property.
+	/// Backing store for the <see cref="FullScreenState"/> property.
+	/// </summary>
+	public static readonly BindableProperty ScreenStateProperty = screenStatePropertyKey.BindableProperty;
+
+	/// <summary>
+	/// Backing store for the <see cref="ShouldAutoPlay"/> property.
 	/// </summary>
 	public static readonly BindableProperty ShouldAutoPlayProperty =
 		BindableProperty.Create(nameof(ShouldAutoPlay), typeof(bool), typeof(MediaElement), MediaElementDefaults.ShouldAutoPlay);
@@ -161,6 +169,13 @@ public event EventHandler SeekCompleted
 		remove => eventManager.RemoveEventHandler(value);
 	}
 
+	/// <inheritdoc cref="IMediaElement.ScreenStateChanged"/>
+	public event EventHandler<ScreenStateChangedEventArgs> ScreenStateChanged
+	{
+		add => eventManager.AddEventHandler(value);
+		remove => eventManager.RemoveEventHandler(value);
+	}
+
 	/// <inheritdoc cref="IMediaElement.StateChanged"/>
 	public event EventHandler<MediaStateChangedEventArgs> StateChanged
 	{
@@ -371,6 +386,15 @@ public MediaElementState CurrentState
 		private set => SetValue(currentStatePropertyKey, value);
 	}
 
+	/// <summary>
+	/// Gets the full screen state of the media element.
+	/// </summary>
+	public MediaElementScreenState FullScreenState
+	{
+		get => (MediaElementScreenState)GetValue(ScreenStateProperty);
+		private set => SetValue(screenStatePropertyKey, value);
+	}
+
 	/// <inheritdoc/>
 	TaskCompletionSource IAsynchronousMediaElementHandler.SeekCompletedTCS => seekCompletedTaskCompletionSource;
 
@@ -527,6 +551,15 @@ static void OnSourcePropertyChanging(BindableObject bindable, object oldValue, o
 		oldMediaSource?.SourceChanged -= mediaElement.OnSourceChanged;
 	}
 
+	static void OnFullScreenPropertyChanged(BindableObject bindable, object oldValue, object newValue)
+	{
+		var mediaElement = (MediaElement)bindable;
+		var previousState = (MediaElementScreenState)oldValue;
+		var newState = (MediaElementScreenState)newValue;
+
+		mediaElement.OnFullScreenChanged(new ScreenStateChangedEventArgs(previousState, newState));
+	}
+
 	static void OnCurrentStatePropertyChanged(BindableObject bindable, object oldValue, object newValue)
 	{
 		var mediaElement = (MediaElement)bindable;
@@ -584,12 +617,17 @@ void OnSourceChanged(object? sender, EventArgs eventArgs)
 		InvalidateMeasure();
 	}
 
+	void IMediaElement.FullScreenChanged(MediaElementScreenState newState) => FullScreenState = newState;
+
 	void OnPositionChanged(MediaPositionChangedEventArgs mediaPositionChangedEventArgs) =>
 		eventManager.HandleEvent(this, mediaPositionChangedEventArgs, nameof(PositionChanged));
 
 	void OnStateChanged(MediaStateChangedEventArgs mediaStateChangedEventArgs) =>
 		eventManager.HandleEvent(this, mediaStateChangedEventArgs, nameof(StateChanged));
 
+	void OnFullScreenChanged(ScreenStateChangedEventArgs fullScreenStateChangedEventArgs) =>
+		eventManager.HandleEvent(this, fullScreenStateChangedEventArgs, nameof(ScreenStateChanged));
+
 	void OnPauseRequested() => eventManager.HandleEvent(this, EventArgs.Empty, nameof(PauseRequested));
 
 	void OnPlayRequested() => eventManager.HandleEvent(this, EventArgs.Empty, nameof(PlayRequested));

src/CommunityToolkit.Maui.MediaElement/Primitives/MediaElementScreenState.cs

@@ -0,0 +1,17 @@
+namespace CommunityToolkit.Maui.Core;
+
+/// <summary>
+/// Represents the different screen states of a media element.
+/// </summary>
+public enum MediaElementScreenState
+{
+	/// <summary>
+	/// The default state.
+	/// </summary>
+	Default = 0,
+
+	/// <summary>
+	/// Full screen.
+	/// </summary>
+	FullScreen = 1,
+}

src/CommunityToolkit.Maui.MediaElement/Primitives/ScreenStateChangedEventArgs.cs

@@ -0,0 +1,23 @@
+namespace CommunityToolkit.Maui.Core;
+
+/// <summary>
+/// Event data for when the full screen state of the media element has changed.
+/// </summary>
+/// <remarks>
+/// Initializes a new instance of the <see cref="ScreenStateChangedEventArgs"/> class.
+/// </remarks>
+/// <param name="previousState"></param>
+/// <param name="newState"></param>
+public sealed class ScreenStateChangedEventArgs(MediaElementScreenState previousState, MediaElementScreenState newState) : EventArgs
+{
+
+	/// <summary>
+	/// Gets the previous state that the <see cref="IMediaElement"/> instance is transitioning from.
+	/// </summary>
+	public MediaElementScreenState PreviousState { get; } = previousState;
+
+	/// <summary>
+	/// Gets the new state that the <see cref="IMediaElement"/> instance is transitioning to.
+	/// </summary>
+	public MediaElementScreenState NewState { get; } = newState;
+}

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

@@ -17,11 +17,17 @@ public class MauiMediaElement : CoordinatorLayout
 {
 	readonly RelativeLayout relativeLayout;
 	readonly PlayerView playerView;
-
+	readonly WeakEventManager fullScreenEventManager = new();
 	int defaultSystemUiVisibility;
 	bool isSystemBarVisible;
 	bool isFullScreen;
 
+	internal event EventHandler<ScreenStateChangedEventArgs> FullScreenStateChanged
+	{
+		add => fullScreenEventManager.AddEventHandler(value);
+		remove => fullScreenEventManager.RemoveEventHandler(value);
+	}
+
 #pragma warning disable CS8618 // Non-nullable field is uninitialized. Consider declaring as nullable.
 #pragma warning disable IDE0060 // Remove unused parameter
 	public MauiMediaElement(nint ptr, JniHandleOwnership jni) : base(Platform.AppContext)
@@ -129,6 +135,10 @@ void OnFullscreenButtonClick(object? sender, PlayerView.FullscreenButtonClickEve
 		}
 		// Hide/Show the SystemBars and Status bar
 		SetSystemBarsVisibility();
+
+		var newState = e.P0 ? MediaElementScreenState.FullScreen : MediaElementScreenState.Default;
+		var oldState = e.P0 ? MediaElementScreenState.Default : MediaElementScreenState.FullScreen;
+		fullScreenEventManager.HandleEvent(this, new ScreenStateChangedEventArgs(oldState, newState), nameof(FullScreenStateChanged));
 	}
 
 	void SetSystemBarsVisibility()

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

@@ -3,8 +3,6 @@
 using CommunityToolkit.Maui.Extensions;
 using CommunityToolkit.Maui.Primitives;
 using CommunityToolkit.Maui.Views;
-using Microsoft.Maui.Controls;
-using Microsoft.Maui.Devices;
 using Microsoft.UI;
 using Microsoft.UI.Windowing;
 using Microsoft.UI.Xaml;
@@ -33,13 +31,21 @@
 		var hwnd = GetForegroundWindow();
 		return hwnd == IntPtr.Zero ? null : hwnd;
 	}
+
+	readonly WeakEventManager fullScreenEventManager = new();
 	readonly Popup popup = new();
 	readonly Grid fullScreenGrid = new();
 	readonly MediaPlayerElement mediaPlayerElement;
 	readonly CustomTransportControls? customTransportControls;
 	bool doesNavigationBarExistBeforeFullScreen;
 	bool isDisposed;
 
+	internal event EventHandler<ScreenStateChangedEventArgs> FullScreenStateChanged
+	{
+		add => fullScreenEventManager.AddEventHandler(value);
+		remove => fullScreenEventManager.RemoveEventHandler(value);
+	}
+
 	/// <summary>
 	/// Initializes a new instance of the <see cref="MauiMediaElement"/> class.
 	/// </summary>
@@ -178,7 +184,7 @@
 	{
 		var currentPage = CurrentPage;
 		var appWindow = GetAppWindowForCurrentWindow();
-
+		var mediaElementState = MediaElementScreenState.Default;
 		if (appWindow.Presenter.Kind is AppWindowPresenterKind.FullScreen)
 		{
 			appWindow.SetPresenter(AppWindowPresenterKind.Default);
@@ -195,6 +201,7 @@
 			var parent = mediaPlayerElement.Parent as FrameworkElement;
 			mediaPlayerElement.Width = parent?.Width ?? mediaPlayerElement.Width;
 			mediaPlayerElement.Height = parent?.Height ?? mediaPlayerElement.Height;
+			mediaElementState = MediaElementScreenState.Default;
 		}
 		else
 		{
@@ -221,6 +228,14 @@
 			{
 				popup.IsOpen = true;
 			}
+			mediaElementState = MediaElementScreenState.FullScreen;
+		}
+		if (mediaElementState is null)
+		{
+			return;
 		}
+		var newState = mediaElementState.Value;
+		var oldState = newState == MediaElementScreenState.FullScreen ? MediaElementScreenState.Default : MediaElementScreenState.FullScreen;
+		fullScreenEventManager.HandleEvent(this, new ScreenStateChangedEventArgs(oldState, newState), nameof(FullScreenStateChanged));
 	}
 }