Fix Crash on iOS when using MediaElement inside a CarouselView

[brminnick]

Description of Change

This Pull Request adds support for MediaElement inside of DataTemplate.

This Pull Request also adds MediaElementCarouselViewPage to the Sample App.

Linked Issues

• Fixes [BUG] Crash on iOS when using MediaElement inside a CarouselView  #1903

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

Additional information

This fix requires reflection because the Controller property that we need to reference when MediaElement is inside of a DataTemplate is a protected internal property in the ItemsViewContoller class: https://github.com/dotnet/maui/blob/cf002538cb73db4bf187a51e4786d7478a7025ee/src/Controls/src/Core/Handlers/Items/ItemsViewHandler.iOS.cs#L39

Because this uses reflection, it is important to manually test the MediaElementCarouselViewPage whenever we update our .NET MAUI Workload (eg net8.0-ios -> net9.0-ios) to ensure there are no breaking changes caused by reflection and/or the renaming of internal properties.

[ne0rrmatrix]

I am very happy to see this PR! I just finished testing it in IOS and for Mac Catalyst. It works as intended and everything is fully working now. The only thing I could think of that could be done in a different PR maybe is adding another page and testing CollectionView. If you want I can add that view or you can do it? It is up to you. But we need to test for that too. I don't know how many times I have manually just created both this view and also Collection View for testing specifically in IOS/Mac. I tested on an Ipad running current version of IOS. It is all working!

[ne0rrmatrix]

As I said in the comment. It all looks good. I am also very happy to report I tested it against a mac and ipad. No issues on either CaraouselView or regular MediaElement. My only wish is to now either have you add another sample page with CollectionView. If you don't want to I would be happy to do it.

[brminnick]

As I said in the comment. It all looks good. I am also very happy to report I tested it against a mac and ipad. No issues on either CaraouselView or regular MediaElement. My only wish is to now either have you add another sample page with CollectionView. If you don't want to I would be happy to do it.

Sure - go for it! I'll go ahead and merge this PR in the meantime to get the bug fix into the code base.

You can assign your PR adding a CollectionView sample to me when it's ready for review 👍

[AndreasHennig]

@brminnick I also just wanted to express my gratitude for the fix - thank you!! 🥳