Allow Developers to Manually Request Permissions when using CameraView, FileSaver, FolderPicker and SpeechToText (#607)

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

* update docs to split required and optional permissions

* Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: VladislavAntonyuk

docs/maui/essentials/file-saver.md

@@ -72,11 +72,35 @@ Add permissions to `tizen-manifest.xml`:
 
 ---
 
-## Syntax
+## Basic usage
 
-### C#
+The `FileSaver` can be added to a .NET MAUI application in the following way.
 
-The `FileSaver` can be used as follows in C#:
+### Request permissions
+
+Developers must manually request Permissions.StorageRead and Permissions.StorageWrite before saving files:
+
+```csharp
+async Task RequestStoragePermissionsAndSaveFile(CancellationToken cancellationToken)
+{
+    var readPermissionStatus = await Permissions.RequestAsync<Permissions.StorageRead>();
+    var writePermissionStatus = await Permissions.RequestAsync<Permissions.StorageWrite>();
+
+    if (readPermissionStatus != PermissionStatus.Granted ||
+        writePermissionStatus != PermissionStatus.Granted)
+    {
+        await Toast
+            .Make("Storage permissions are required to save files.")
+            .Show(cancellationToken);
+
+        return;
+    }
+
+    await SaveFile(cancellationToken);
+}
+```
+
+### Save file
 
 ```csharp
 async Task SaveFile(CancellationToken cancellationToken)

docs/maui/essentials/folder-picker.md

@@ -65,11 +65,19 @@ Add permissions to `tizen-manifest.xml`:
 
 ---
 
-## Syntax
+## Basic usage
 
-### C#
+The `FolderPicker` can be added to a .NET MAUI application in the following way.
 
-The `FolderPicker` can be used as follows in C#:
+### Request permissions
+
+Developers must manually request Permissions.StorageRead:
+
+```csharp
+var readPermissionsRequest = await Permissions.RequestAsync<Permissions.StorageRead>();
+```
+
+### Pick folder
 
 ```csharp
 async Task PickFolder(CancellationToken cancellationToken)

docs/maui/essentials/speech-to-text.md

@@ -55,11 +55,26 @@ Add permissions to `tizen-manifest.xml`:
 
 ---
 
-## Syntax
+## Basic usage
 
-### C#
+The `SpeechToText` can be added to a .NET MAUI application in the following way.
 
-The `SpeechToText` can be used as follows in C#:
+### Request permissions
+
+Developers must manually request Permissions.Microphone and also call ISpeechToText.RequestPermissions():
+    
+```csharp
+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;
+}
+```
+
+### Speech To Text
 
 ```csharp
 async Task StartListening(CancellationToken cancellationToken)

docs/maui/views/camera-view.md

@@ -25,6 +25,11 @@ The following permissions need to be added to the `Platforms/Android/AndroidMani
 <uses-permission android:name="android.permission.CAMERA" />
 ```
 
+In case you plan to record video, request Microphone permissions:
+```xml
+<uses-permission android:name="android.permission.RECORD_AUDIO" />
+```
+
 This should be added inside the `<manifest>` element. Below shows a more complete example:
 
 ```xml
@@ -34,6 +39,9 @@ This should be added inside the `<manifest>` element. Below shows a more complet
 
     <uses-permission android:name="android.permission.CAMERA" />
 
+    <!--Optional. Only for video recording-->
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
+
 </manifest>
 ```
 
@@ -46,6 +54,12 @@ The following entries need to be added to the `Platforms/iOS/Info.plist` file:
 <string>PROVIDE YOUR REASON HERE</string>
 ```
 
+In case you plan to record video, request Microphone permissions:
+```xml
+<key>NSMicrophoneUsageDescription</key>
+<string>PROVIDE YOUR REASON HERE</string>
+```
+
 This should be added inside the `<dict>` element. Below shows a more complete example:
 
 ```xml
@@ -96,6 +110,12 @@ The following entries need to be added to the `Platforms/MacCatalyst/Info.plist`
 <string>PROVIDE YOUR REASON HERE</string>
 ```
 
+In case you plan to record video, request Microphone permissions:
+```xml
+<key>NSMicrophoneUsageDescription</key>
+<string>PROVIDE YOUR REASON HERE</string>
+```
+
 This should be added inside the `<dict>` element. Below shows a more complete example:
 
 ```xml
@@ -155,6 +175,20 @@ Tizen is not currently supported.
 
 The `CameraView` can be added to a .NET MAUI application in the following way.
 
+### Request permissions
+
+Developers must manually request Permissions.Camera and/or Permissions.Microphone:
+
+```csharp
+var cameraPermissionsRequest = await Permissions.RequestAsync<Permissions.Camera>();
+```
+
+In case you plan to record video, request Microphone permissions:
+
+```csharp
+var microphonePermissionsRequest = await Permissions.RequestAsync<Permissions.Microphone>();
+```
+
 ### Including the XAML namespace
 
 [!INCLUDE [XAML usage guidance](../includes/xaml-usage.md)]