Full screen events

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

@@ -38,7 +38,8 @@
                 MediaOpened="OnMediaOpened"
                 PositionChanged="OnPositionChanged"
                 StateChanged="OnStateChanged"
-                SeekCompleted="OnSeekCompleted"/>
+                SeekCompleted="OnSeekCompleted"
+                FullScreenStateChanged="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

@@ -1,5 +1,6 @@
 using System.ComponentModel;
 using CommunityToolkit.Maui.Core.Primitives;
+using CommunityToolkit.Maui.Primitives;
 using CommunityToolkit.Maui.Sample.ViewModels.Views;
 using CommunityToolkit.Maui.Views;
 using Microsoft.Extensions.Logging;
@@ -30,6 +31,8 @@ public MediaElementPage(MediaElementViewModel viewModel, ILogger<MediaElementPag
 		MediaElement.PropertyChanged += MediaElement_PropertyChanged;
 	}
 
+	void MediaElement_FullScreenStateChanged(object? sender, FullScreenStateChangedEventArgs 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/Interfaces/IMediaElement.cs

@@ -1,4 +1,5 @@
 using CommunityToolkit.Maui.Core.Primitives;
+using CommunityToolkit.Maui.Primitives;
 using CommunityToolkit.Maui.Views;
 
 namespace CommunityToolkit.Maui.Core;
@@ -34,6 +35,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 +117,11 @@ public interface IMediaElement : IView, IAsynchronousMediaElementHandler
 	/// </summary>
 	event EventHandler<MediaPositionChangedEventArgs> PositionChanged;
 
+	/// <summary>
+	/// Occurs when the <see cref="FullScreenState"/> changes.
+	/// </summary>
+	event EventHandler<FullScreenStateChangedEventArgs> FullScreenStateChanged;
+
 	/// <summary>
 	/// Occurs when the media has ended playing successfully.
 	/// </summary>
@@ -161,4 +172,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.
+	/// </summary>
+	/// <param name="newState"></param>
+	internal void FullScreenChanged(MediaElementScreenState newState);
 }

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

@@ -2,6 +2,7 @@
 using CommunityToolkit.Maui.Converters;
 using CommunityToolkit.Maui.Core;
 using CommunityToolkit.Maui.Core.Primitives;
+using CommunityToolkit.Maui.Primitives;
 
 namespace CommunityToolkit.Maui.Views;
 
@@ -31,6 +32,13 @@ public partial class MediaElement : View, IMediaElement, IDisposable
 	/// </summary>
 	public static readonly BindableProperty DurationProperty = durationPropertyKey.BindableProperty;
 
+	/// <summary>
+	/// Backing store for the <see cref="FullScreenState"/> property.
+	/// </summary>
+	public static readonly BindableProperty FullScreenProperty =
+		BindableProperty.Create(nameof(FullScreenState), typeof(MediaElementScreenState), typeof(MediaElement), 
+			MediaElementScreenState.Default, propertyChanged: OnFullScreenPropertyChanged);
+
 	/// <summary>
 	/// Backing store for the <see cref="ShouldAutoPlay"/> property.
 	/// </summary>
@@ -155,6 +163,13 @@ public event EventHandler SeekCompleted
 		remove => eventManager.RemoveEventHandler(value);
 	}
 
+	/// <inheritdoc cref="IMediaElement.FullScreenStateChanged"/>
+	public event EventHandler<FullScreenStateChangedEventArgs> FullScreenStateChanged
+	{
+		add => eventManager.AddEventHandler(value);
+		remove => eventManager.RemoveEventHandler(value);
+	}
+
 	/// <inheritdoc cref="IMediaElement.StateChanged"/>
 	public event EventHandler<MediaStateChangedEventArgs> StateChanged
 	{
@@ -390,6 +405,15 @@ public MediaElementState CurrentState
 		private set => SetValue(CurrentStateProperty, value);
 	}
 
+	/// <summary>
+	/// Gets the full screen state of the media element.
+	/// </summary>
+	public MediaElementScreenState FullScreenState
+	{
+		get => (MediaElementScreenState)GetValue(FullScreenProperty);
+		private set => SetValue(FullScreenProperty, value);
+	}
+
 	TimeSpan IMediaElement.Position
 	{
 		get => (TimeSpan)GetValue(PositionProperty);
@@ -527,6 +551,15 @@ static void OnSourcePropertyChanged(BindableObject bindable, object oldValue, ob
 	static void OnSourcePropertyChanging(BindableObject bindable, object oldValue, object newValue) =>
 		((MediaElement)bindable).OnSourcePropertyChanging((MediaSource?)oldValue);
 
+	static void OnFullScreenPropertyChanged(BindableObject bindable, object oldValue, object newValue)
+	{
+		var MediaElement = (MediaElement)bindable;
+		var previousState = (MediaElementScreenState)oldValue;
+		var newState = (MediaElementScreenState)newValue;
+
+		MediaElement.OnFullScreenChanged(new FullScreenStateChangedEventArgs(previousState, newState));
+	}
+
 	static void OnCurrentStatePropertyChanged(BindableObject bindable, object oldValue, object newValue)
 	{
 		var mediaElement = (MediaElement)bindable;
@@ -630,12 +663,17 @@ void IMediaElement.SeekCompleted()
 
 	void IMediaElement.CurrentStateChanged(MediaElementState newState) => CurrentState = newState;
 
+	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(FullScreenStateChangedEventArgs fullScreenStateChangedEventArgs) =>
+		eventManager.HandleEvent(this, fullScreenStateChangedEventArgs, nameof(FullScreenStateChanged));
+
 	void OnPauseRequested() => eventManager.HandleEvent(this, EventArgs.Empty, nameof(PauseRequested));
 
 	void OnPlayRequested() => eventManager.HandleEvent(this, EventArgs.Empty, nameof(PlayRequested));

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

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

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

@@ -0,0 +1,17 @@
+namespace CommunityToolkit.Maui.Primitives;
+
+/// <summary>
+/// 
+/// </summary>
+public enum MediaElementScreenState
+{
+	/// <summary>
+	/// Full screen.
+	/// </summary>
+	FullScreen,
+
+	/// <summary>
+	/// The default state.
+	/// </summary>
+	Default,
+}

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

@@ -6,6 +6,7 @@
 using AndroidX.CoordinatorLayout.Widget;
 using AndroidX.Core.View;
 using AndroidX.Media3.UI;
+using CommunityToolkit.Maui.Primitives;
 using CommunityToolkit.Maui.Views;
 
 namespace CommunityToolkit.Maui.Core.Views;
@@ -120,12 +121,14 @@ void OnFullscreenButtonClick(object? sender, PlayerView.FullscreenButtonClickEve
 			isFullScreen = true;
 			RemoveView(relativeLayout);
 			layout?.AddView(relativeLayout);
+			MediaManager.FullScreenEvents.OnWindowsChanged(new FullScreenStateChangedEventArgs(MediaElementScreenState.Default, MediaElementScreenState.FullScreen));
 		}
 		else
 		{
 			isFullScreen = false;
 			layout?.RemoveView(relativeLayout);
 			AddView(relativeLayout);
+			MediaManager.FullScreenEvents.OnWindowsChanged(new FullScreenStateChangedEventArgs(MediaElementScreenState.FullScreen, MediaElementScreenState.Default));
 		}
 		// Hide/Show the SystemBars and Status bar
 		SetSystemBarsVisibility();

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

@@ -1,4 +1,5 @@
 using CommunityToolkit.Maui.Extensions;
+using CommunityToolkit.Maui.Primitives;
 using CommunityToolkit.Maui.Views;
 using Microsoft.UI;
 using Microsoft.UI.Windowing;
@@ -169,6 +170,7 @@ void OnFullScreenButtonClick(object sender, RoutedEventArgs e)
 			var parent = mediaPlayerElement.Parent as FrameworkElement;
 			mediaPlayerElement.Width = parent?.Width ?? mediaPlayerElement.Width;
 			mediaPlayerElement.Height = parent?.Height ?? mediaPlayerElement.Height;
+			MediaManager.FullScreenEvents.OnWindowsChanged(new FullScreenStateChangedEventArgs(MediaElementScreenState.FullScreen, MediaElementScreenState.Default));
 		}
 		else
 		{
@@ -197,6 +199,7 @@ void OnFullScreenButtonClick(object sender, RoutedEventArgs e)
 			{
 				popup.IsOpen = true;
 			}
+			MediaManager.FullScreenEvents.OnWindowsChanged(new FullScreenStateChangedEventArgs(MediaElementScreenState.Default, MediaElementScreenState.FullScreen));
 		}
 	}
 }

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

@@ -1,6 +1,7 @@
 using AVFoundation;
 using AVKit;
 using CommunityToolkit.Maui.Core.Primitives;
+using CommunityToolkit.Maui.Primitives;
 using CommunityToolkit.Maui.Views;
 using CoreFoundation;
 using CoreGraphics;
@@ -95,7 +96,8 @@ public partial class MediaManager : IDisposable
 		Player = new();
 		PlayerViewController = new()
 		{
-			Player = Player
+			Player = Player,
+			Delegate = new MediaManagerDelegate()
 		};
 		// Pre-initialize Volume and Muted properties to the player object
 		Player.Muted = MediaElement.ShouldMute;
@@ -718,4 +720,16 @@ void RateChanged(object? sender, NSNotificationEventArgs args)
 			}
 		}
 	}
+}
+
+sealed class MediaManagerDelegate : AVPlayerViewControllerDelegate
+{
+	public override void WillBeginFullScreenPresentation(AVPlayerViewController playerViewController, IUIViewControllerTransitionCoordinator coordinator)
+	{
+		MediaManager.FullScreenEvents.OnWindowsChanged(new FullScreenStateChangedEventArgs(MediaElementScreenState.Default, MediaElementScreenState.FullScreen));
+	}
+	public override void WillEndFullScreenPresentation(AVPlayerViewController playerViewController, IUIViewControllerTransitionCoordinator coordinator)
+	{
+		MediaManager.FullScreenEvents.OnWindowsChanged(new FullScreenStateChangedEventArgs(MediaElementScreenState.FullScreen, MediaElementScreenState.Default));
+	}
 }

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

@@ -1,4 +1,5 @@
-#if !(ANDROID || IOS || WINDOWS || MACCATALYST || TIZEN)
+// NOTE: PR shares code with #1918 https://github.com/CommunityToolkit/Maui/pull/1918
+#if !(ANDROID || IOS || WINDOWS || MACCATALYST || TIZEN)
 global using PlatformMediaElement = System.Object;
 #elif ANDROID
 global using PlatformMediaElement = AndroidX.Media3.ExoPlayer.IExoPlayer;
@@ -10,6 +11,7 @@
 global using PlatformMediaElement = CommunityToolkit.Maui.Core.Views.TizenPlayer;
 #endif
 
+using CommunityToolkit.Maui.Primitives;
 using Microsoft.Extensions.Logging;
 
 namespace CommunityToolkit.Maui.Core.Views;
@@ -36,6 +38,40 @@ public MediaManager(IMauiContext context, IMediaElement mediaElement, IDispatche
 		MediaElement = mediaElement;
 
 		Logger = MauiContext.Services.GetRequiredService<ILoggerFactory>().CreateLogger(nameof(MediaManager));
+		FullScreenEvents.WindowsChanged += OnFullScreenStatusChanged;
+	}
+
+	/// <summary>
+	/// An event that is raised when the full screen state of the media element has changed.
+	/// </summary>
+	internal readonly record struct FullScreenEvents()
+	{
+		/// <summary>
+		/// An event that is raised when the full screen state of the media element has changed.
+		/// </summary>
+		public static event EventHandler<FullScreenStateChangedEventArgs>? WindowsChanged;
+		/// <summary>
+		/// An event that is raised when the full screen state of the media element has changed.
+		/// </summary>
+		/// <param name="e"></param>
+		public static void OnWindowsChanged(FullScreenStateChangedEventArgs e) => WindowsChanged?.Invoke(null, e);
+	}
+
+	/// <summary>
+	/// 
+	/// </summary>
+	/// <param name="sender"></param>
+	/// <param name="e"></param>
+	protected void OnFullScreenStatusChanged(object? sender, FullScreenStateChangedEventArgs e)
+	{
+		if (MediaElement is not null)
+		{
+			MediaElement.FullScreenChanged(e.NewState);
+		}
+		else
+		{
+			Logger?.LogWarning("MediaElement is null");
+		}
 	}
 
 	/// <summary>