Allow Developers to Manually Request Permissions when using CameraView, FileSaver, FolderPicker and SpeechToText

[VladislavAntonyuk]

Description of Change

Linked Issues

• Fixes [BUG] iOS app crash due to forced Microphone permission request #2930

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

Breaking Changes

• (CameraView) Developers must manually request Permissions.Camera and Permissions.Microphone:

var cameraPermissionsRequest = await Permissions.RequestAsync<Permissions.Camera>();
var microphonePermissionsRequest = await Permissions.RequestAsync<Permissions.Microphone>();

• (FileSaver) Developers must manually request Permissions.StorageRead and Permissions.StorageWrite:

var readPermissionStatus = await Permissions.RequestAsync<Permissions.StorageRead>();
var writePermissionStatus = await Permissions.RequestAsync<Permissions.StorageWrite>();

• (FolderPicker) Developers must manually request Permissions.StorageRead and Permissions.StorageWrite:

var readPermissionStatus = await Permissions.RequestAsync<Permissions.StorageRead>();
var writePermissionStatus = await Permissions.RequestAsync<Permissions.StorageWrite>();

• (SpeechToText) Developers must manually request permissions for Permissions.Microphone and manually call ISpeechToText.RequestPermissions():

    static async Task<bool> ArePermissionsGranted(ISpeechToText speechToText)
    {
        var microphonePermissionStatus = await Permissions.RequestAsync<Permissions.Microphone>();
        var isSpeechToTextRequestPermissionsGranted = await speechToText.RequestPermissions(CancellationToken.None);

        return microphonePermissionStatus is PermissionStatus.Granted
               && isSpeechToTextRequestPermissionsGranted;
    }

[Copilot]

Pull Request Overview

This PR removes automatic permission checking from internal implementation methods and shifts responsibility for permission handling to the consuming application layer. This architectural change allows developers to have more control over when and how they request permissions from users.

Key changes:

• Removed automatic permission checks from StartListenAsync methods in speech-to-text implementations
• Removed internal IsSpeechPermissionAuthorized helper methods
• Removed automatic permission checks from file system operations (FileSaver, FolderPicker) on Android and Tizen
• Removed ArePermissionsGranted method from CameraManager
• Updated sample apps to explicitly request permissions before using these features

Reviewed Changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
SpeechToTextImplementation.shared.cs	Removed automatic microphone permission check from StartListenAsync and deleted IsSpeechPermissionAuthorized helper method
SharedSpeechToTextImplementation.macios.cs	Removed macOS/iOS-specific IsSpeechPermissionAuthorized helper method
OfflineSpeechToTextImplementation.shared.cs	Removed automatic microphone permission check from offline speech recognition's StartListenAsync
FolderPickerImplementation.tizen.cs	Removed automatic storage permission request from Tizen folder picker
FolderPickerImplementation.android.cs	Removed automatic storage permission request for Android versions below 33
FileSaverImplementation.tizen.cs	Removed automatic storage permission request from Tizen file saver
FileSaverImplementation.android.cs	Removed automatic storage permission request for Android versions below 33
CameraViewHandler.shared.cs	Removed automatic permission check before connecting camera
CameraManager.shared.cs	Removed ArePermissionsGranted public method entirely
SpeechToTextViewModel.cs	Added RequestPermissions method to request both microphone and speech recognition permissions
OfflineSpeechToTextViewModel.cs	Added RequestPermissions method to request both microphone and speech recognition permissions
FolderPickerViewModel.cs	Added RequestPermissions method to request storage permissions before each operation
FileSaverViewModel.cs	Added RequestPermissions method to request storage permissions before each operation
CameraViewPage.xaml.cs	Added permission requests in OnAppearing and SaveVideo methods

[Copilot]

Pull Request Overview

Copilot reviewed 15 out of 15 changed files in this pull request and generated 14 comments.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[TheCodeTraveler]

Thanks Vlad!! Could you please open a Docs PR updating users that they need to manually request permissions on the following platforms and provide examples in the docs:

• CameraView
• FileSaver
• FolderPicker
• SpeechToText