Fix MediaElement not working on FlyoutPage in IOS/MAC Catalyst

[ne0rrmatrix]

• Bug fix

Description of Change

Support for Media Element on a FlyoutPage does not currently work on IOS. This adds support for it on IOS and Mac Catalyst.

Linked Issues

• Fixes iOS MediaElement in CollectionView on FlyoutPage #2517

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

Additional information

Windows and android already support playback on a FlyoutPage.

[TheCodeTraveler]

@ne0rrmatrix How are you able to test + verify this fix works for a FlyoutPage?

This PR doesn't include an update to the sample app or additional unit tests. Any time we fix a bug, we should add a unit test, if possible, and add update the sample app to demonstrate it working (aka a Regression Test).

[ne0rrmatrix]

I will update the PR with a sample and create tests. Ty.

[ne0rrmatrix]

I tested against the provided sample showing isdue

[TheCodeTraveler]

I recommend doing two things to make this more robust:

1. Update PageExtensions.GetCurrentPage() to match the most-recent implementation of Microsoft.Maui.Controls.Platform.PageExtensions
2. Update TryGetCurrentPage to use the GetCurrentPage() extension method which already checks for FlyoutPage:

static bool TryGetCurrentPage([NotNullWhen(true)] out Page? currentPage)
{
	currentPage = null;

	if (Application.Current?.Windows is null)
	{
		return false;
	}

	if (Application.Current.Windows.Count is 0)
	{
		throw new InvalidOperationException("Unable to find active Window");
	}

	if (Application.Current.Windows.Count > 1)
	{
		// We are unable to determine which Window contains the ItemsView that contains the MediaElement when multiple ItemsView are being used in the same page
		// TODO: Add support for MediaElement in an ItemsView in a multi-window application
		throw new NotSupportedException("MediaElement is not currently supported in multi-window applications");
	}

	var window = Application.Current.Windows[0];

	// If using Shell, return the current page
	if (window.Page is Shell { CurrentPage: not null } shell)
	{
		currentPage = shell.CurrentPage;
		return true;
	}

	// If not using Shell, use the ModelNavigationStack to check for any pages displayed modally
	if (TryGetModalPage(window, out var modalPage))
	{
		currentPage = modalPage;
		return true;
	}

	if (window.Page is Page page)
	{
		currentPage = page.GetCurrentPage();
		return true;
	}

	return false;

	static bool TryGetModalPage(Window window, [NotNullWhen(true)] out Page? page)
	{
		page = window.Navigation.ModalStack.LastOrDefault();
		return page is not null;
	}
}

[ne0rrmatrix]

I have updated page extensions and tryGetCurrentPage as requested. I will start trying to figure out how to implement a FlyoutPage with sample app. Implementing the logic to handle a flyout page and a non shell app will be challenging.

Device specific tests for IOS/Mac to test this can be done. I am not sure if that is what you are looking for? If so I can do that. I hope I am not too off track with that line of reasoning.

[Copilot]

Pull Request Overview

This PR fixes a bug where MediaElement was not working on FlyoutPage in iOS and Mac Catalyst platforms. The fix centralizes page navigation logic by creating a shared PageExtensions.GetCurrentPage method that properly handles different page types including modal pages, FlyoutPages, Shell, and page containers.

Key changes:

• Added comprehensive page navigation logic to handle FlyoutPage scenarios
• Refactored platform-specific code to use shared extension method
• Added unit tests to verify the page resolution functionality

Reviewed Changes

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

File	Description
PageExtensions.shared.cs	Implements centralized page resolution logic with support for modal pages, FlyoutPage, Shell, and page containers
MauiMediaElement.macios.cs	Simplifies iOS/Mac Catalyst implementation to use the shared page resolution method
PageExtensionsTests.cs	Adds comprehensive unit tests covering all page resolution scenarios

Comments suppressed due to low confidence (2)

src/CommunityToolkit.Maui.MediaElement/Extensions/PageExtensions.shared.cs:29

• Missing closing brace for the GetCurrentPage method. The method body appears to be incomplete as it's missing the closing brace.

	}