Add initial media options class and extension

[bijington]

Description of Change

The aim of this PR is to highlight how we can initially make MediaElement more configurable but we should consider how this could enable developers to configure any of our internal defaults classes.

Linked Issues

• Fixes #

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

[bijington]

@ne0rrmatrix this was my initial thinking, I have noticed that we don't currently set these values when controlling playback within our codebase but I believe your PR #1782 does.

@VladislavAntonyuk what are your thoughts on expanding this out of a MediaOptions class to enable support for also controlling the SpeechToText AVAudioSession values?

@everyone what do you think to expanding our options classes to allow for configuring all defaults within the toolkit? We already have classes that represent the defaults e.g. TouchBehaviorDefaults if we make this configurable it could make the usage of the controls simpler.

[pictos]

I really like the idea of extending our features using these Options objects. I believe it will help devs to customize the behavior of the feature easily.

[pictos]

I would say those Options should be immutable. So we can refactor it to be a record and remove the setters

[pictos]

Here's is fine to be mutable, since users may want to change how options based on the MediaSource. But, it does make sense on the current implementation? The MediaOptions is only configurable on AppBuilder, so it shouldn't change after app startup, right?

[brminnick]

Agreed. Let's make these { get; private set;} for now to follow the same architecture in CommunityToolkit.Maui.Options:

Maui/src/CommunityToolkit.Maui/Options.cs

Lines 19 to 22 in d6d6e18

	internal static bool ShouldSuppressExceptionsInAnimations { get; private set; }
	internal static bool ShouldSuppressExceptionsInConverters { get; private set; }
	internal static bool ShouldSuppressExceptionsInBehaviors { get; private set; }
	internal static bool ShouldEnableSnackbarOnWindows { get; private set; }

We can always make it a public set; in the future without breaking changes.

[ne0rrmatrix]

Do we want to add bindable properties so we can use this at runtime for changes with MediaSource ?

Copilot reviewed 4 out of 4 changed files in this pull request and generated no suggestions.

Comments skipped due to low confidence (3)

src/CommunityToolkit.Maui.MediaElement/Options/MediaOptions.macios.cs:10

• The behavior of the 'Category' property in 'MediaOptions' is not covered by tests. Please add tests to ensure its correct behavior.

public AVAudioSessionCategory Category { get; set; } = AVAudioSessionCategory.Record;

src/CommunityToolkit.Maui.MediaElement/Options/MediaOptions.macios.cs:15

• The behavior of the 'Mode' property in 'MediaOptions' is not covered by tests. Please add tests to ensure its correct behavior.

public AVAudioSessionMode Mode { get; set; } = default;

src/CommunityToolkit.Maui.MediaElement/Options/MediaOptions.macios.cs:20

• The behavior of the 'CategoryOptions' property in 'MediaOptions' is not covered by tests. Please add tests to ensure its correct behavior.

public AVAudioSessionCategoryOptions CategoryOptions { get; set; } = default;