Full screen events

[ne0rrmatrix]

• Feature/Proposal

Add Support for Full Screen Events for Windows, Android, iOS and Mac Catalyst.

Description of Change

Add event handlers to notify developer when full screen status changes.

API:

/// <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>
/// Gets the full screen state of the media element.
/// </summary>
public MediaElementScreenState FullScreenState
{
	get => (MediaElementScreenState)GetValue(FullScreenProperty);
	private set => SetValue(FullScreenProperty, value);
}

XAML:

<toolkit:MediaElement
    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"
    FullScreenStateChanged="MediaElement_FullScreenStateChanged"/>

Code Behind:

void MediaElement_FullScreenStateChanged(object? sender, FullScreenStateChangedEventArgs e) =>
	logger.LogInformation("FullScreen State Changed. Old State: {PreviousState}, New State: {NewState}", e.PreviousState, e.NewState);

Linked Issues

• Fixes [Proposal] API that allows developers to hook a media element event and know the full screen status. #1927

PR Checklist

• Has a linked Issue, and the Issue has been approved(bug) or Championed (feature/proposal)
• Has tests (if omitted, state reason in description)
• Has samples (if omitted, state reason in description)
• Rebased on top of main at time of PR
• Changes adhere to coding standard
• Documentation created or updated: https://github.com/MicrosoftDocs/CommunityToolkit/pulls/446

Additional information

This is a PR to implement a solution for adding support for developers to have an the choice to see when user goes into full full screen and back again.

Note for Maintainers: If you see a need for a name change please go ahead and edit. Names are important. I have no opinion on naming of classes/functions/variables. If you see a need for them to change feel free to make those edits.

[Copilot]

Pull Request Overview

This PR adds full screen event support to the MediaElement control across multiple platforms including Windows, Android, iOS, and Mac Catalyst. Key changes include the introduction of a new full screen state enum and event args, integration of full screen state change events into the MediaManager and MediaElement implementations, and corresponding updates to the interface and sample usage.

Reviewed Changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
src/CommunityToolkit.Maui.MediaElement/Primitives/MediaElementFullScreenState.cs	Added enum for full screen state with two states (FullScreen, Default).
src/CommunityToolkit.Maui.MediaElement/Primitives/FullScreenStateChangedEventArgs.cs	Introduced event arguments for full screen state change.
src/CommunityToolkit.Maui.MediaElement/Views/MediaManager.shared.cs	Integrated full screen events by subscribing and handling events via a new record struct.
src/CommunityToolkit.Maui.MediaElement/Views/MauiMediaElement.windows.cs	Triggered full screen state changes on button clicks.
src/CommunityToolkit.Maui.MediaElement/Interfaces/IMediaElement.cs	Added the FullScreenState property and the FullScreenStateChanged event to the interface.
src/CommunityToolkit.Maui.MediaElement/MediaElement.shared.cs	Updated MediaElement implementation with full screen state support.
src/CommunityToolkit.Maui.MediaElement/Views/MediaManager.macios.cs	Implemented full screen event handling via a custom delegate.
src/CommunityToolkit.Maui.MediaElement/Views/MauiMediaElement.android.cs	Updated full screen transitions to trigger the new events.
samples/CommunityToolkit.Maui.Sample/Pages/Views/MediaElement/MediaElementPage.xaml.cs	Added sample logging for full screen state changes.

Comments suppressed due to low confidence (2)

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

• The event name 'WindowsChanged' could be misleading since it is used for full screen state changes on all platforms. Consider renaming it to 'FullScreenStateChanged' or a similarly descriptive name.

public static event EventHandler<FullScreenStateChangedEventArgs>? WindowsChanged;

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

• The local variable 'MediaElement' should be renamed using camelCase (e.g., 'mediaElement') to follow C# naming conventions.

var MediaElement = (MediaElement)bindable;