Adding update for Explicit consent in native

Author: Sonali Saxena

articles/communication-services/how-tos/calling-sdk/call-transcription.md

@@ -80,8 +80,8 @@ The following table shows the minimum version of SDKs that support individual AP
 |------------|-----|--------|-----|--------|---------|------------|---------|
 | Get event that transcription has started | 1.0.0, 1.25.3-beta.1 | 1.0.0, 1.0.0-beta.8 | 2.1.0, 2.1.0-beta.1 | 1.0.0, 1.0.0-beta.8 | 1.1.0, 1.2.0-beta.1 | 1.0.0, 1.0.0-beta.8 | 1.0.0, 1.0.0-beta.31 |
 | Get transcription state | 1.0.0, 1.25.3-beta.1 | 1.0.0, 1.0.0-beta.8 | 2.1.0, 2.1.0-beta.1 | 1.0.0, 1.0.0-beta.8 | 1.1.0, 1.2.0-beta.1 | 1.0.0, 1.0.0-beta.8 | 1.0.0, 1.0.0-beta.31 |
-| Learn whether explicit consent is required | 1.31.2, 1.32.1-beta.1 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| Give explicit consent for being recorded | 1.31.2, 1.32.1-beta.1 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| Learn whether explicit consent is required  | 1.31.2, 1.32.1-beta.1 | ❌ | 2.16.0-beta.1  | ❌ | 2.14.0-beta.1  | ❌ | 1.12.0-beta.1 |
+| Give explicit consent for being recorded | 1.31.2, 1.32.1-beta.1 | ❌ | 2.16.0-beta.1  | ❌ | 2.14.0-beta.1  | ❌ | 1.12.0-beta.1 |
 
 ## Next steps
 - [Learn how to manage video](./manage-video.md)

articles/communication-services/how-tos/calling-sdk/includes/call-transcription/call-transcription-android.md

@@ -31,3 +31,21 @@ private void handleCallOnIsTranscriptionChanged(PropertyChangedEvent args) {
 
 callTranscriptionFeature.addOnIsTranscriptionActiveChangedListener(handleCallOnIsTranscriptionChanged);
 ```
+
+## Explicit Consent
+[!INCLUDE [Public Preview Disclaimer](../../../../includes/Public-Preview-Note-android.md)]
+
+When your Teams meeting or call is configured to require explicit consent for recording or transcription, you're required to gather explicit consent from your users to allow users to be transcribed or recorded. You can provide consent proactively when joining the meeting or reactively when the recording or transcription starts. Until explicit consent is given, participants' audio, video, and screen sharing will be disabled during transcription.
+
+You can check if the meeting transcription requires explicit consent by property `isTeamsConsentRequired()`. If the value is set to `true`, then explicit consent is required for the `call`.
+
+```java
+boolean isTranscriptionConsentRequired = callTranscriptionFeature.isTeamsConsentRequired();
+```
+
+If you have already obtained the user's consent for transcription, you can call the `grantTeamsConsent()` method to indicate explicit consent to the service. This consent is valid for one `call` session only and users need to provide consent again if they rejoin the meeting.
+
+```java
+callTranscriptionFeature.grantTeamsConsent();
+```
+Attempts to enable audio, video, or screen sharing fail when transcription is active, explicit consent is required but isn't yet given. You can recognize this situation by checking property `reason` of class `ParticipantCapabilities` for [capabilities](../../capabilities.md) `turnVideoOn`, `unmuteMic` and `shareScreen`. You can find those [capabilities](../../capabilities.md) in the feature `call.feature(Features.Capabilities)`. Those [capabilities](../../capabilities.md) would return reason `ExplicitConsentRequired` as users need to provide explicit consent.

articles/communication-services/how-tos/calling-sdk/includes/call-transcription/call-transcription-ios.md

@@ -32,3 +32,20 @@ public func transcriptionCallFeature(_ transcriptionCallFeature: TranscriptionCa
     let isTranscriptionActive = callTranscriptionFeature.isTranscriptionActive
 }
 ```
+## Explicit Consent
+[!INCLUDE [Public Preview Disclaimer](../../../../includes/Public-Preview-Note-ios.md)]
+
+When your Teams meeting or call is configured to require explicit consent for recording or transcription, you're required to gather explicit consent from your users to allow users to be transcribed or recorded. You can provide consent proactively when joining the meeting or reactively when the recording or transcription starts. Until explicit consent is given, participants' audio, video, and screen sharing will be disabled during transcription.
+
+You can check if the meeting transcription requires explicit consent by property `isTeamsConsentRequired`. If the value is set to `true`, then explicit consent is required for the `call`.
+
+```swift
+let isTranscriptionConsentRequired = callTranscriptionFeature.isTeamsConsentRequired;
+```
+
+If you have already obtained the user's consent for transcription, you can call the `grantTeamsConsent()` method to indicate explicit consent to the service. This consent is valid for one `call` session only and users need to provide consent again if they rejoin the meeting.
+
+```swift
+callTranscriptionFeature.grantTeamsConsent();
+```
+Attempts to enable audio, video, or screen sharing fail when transcription is active, explicit consent is required but isn't yet given. You can recognize this situation by checking property `reason` of class `ParticipantCapabilities` for [capabilities](../../capabilities.md) `turnVideoOn`, `unmuteMic` and `shareScreen`. You can find those [capabilities](../../capabilities.md) in the feature `call.feature(Features.Capabilities)`. Those [capabilities](../../capabilities.md) would return reason `ExplicitConsentRequired` as users need to provide explicit consent.

articles/communication-services/how-tos/calling-sdk/includes/call-transcription/call-transcription-windows.md

@@ -29,3 +29,20 @@ private async void Call__OnIsTranscriptionActiveChanged(object sender, PropertyC
 
 transcriptionFeature.IsTranscriptionActiveChanged += Call__OnIsTranscriptionActiveChanged;
 ```
+## Explicit Consent
+[!INCLUDE [Public Preview Disclaimer](../../../../includes/Public-Preview-Note-windows.md)]
+
+When your Teams meeting or call is configured to require explicit consent for recording or transcription, you're required to gather explicit consent from your users to allow users to be transcribed or recorded. You can provide consent proactively when joining the meeting or reactively when the recording or transcription starts. Until explicit consent is given, participants' audio, video, and screen sharing will be disabled during transcription.
+
+You can check if the meeting transcription requires explicit consent by property `isTeamsConsentRequired`. If the value is set to `true`, then explicit consent is required for the `call`.
+
+```csharp
+boolean isTranscriptionConsentRequired = transcriptionFeature.isTeamsConsentRequired;
+```
+
+If you have already obtained the user's consent for transcription, you can call the `grantTeamsConsent()` method to indicate explicit consent to the service. This consent is valid for one `call` session only and users need to provide consent again if they rejoin the meeting.
+
+```csharp
+transcriptionFeature.grantTeamsConsent();
+```
+Attempts to enable audio, video, or screen sharing fail when transcription is active, explicit consent is required but isn't yet given. You can recognize this situation by checking property `reason` of class `ParticipantCapabilities` for [capabilities](../../capabilities.md) `turnVideoOn`, `unmuteMic` and `shareScreen`. You can find those [capabilities](../../capabilities.md) in the feature `call.feature(Features.Capabilities)`. Those [capabilities](../../capabilities.md) would return reason `ExplicitConsentRequired` as users need to provide explicit consent.

articles/communication-services/how-tos/calling-sdk/includes/record-calls/record-calls-android.md

@@ -9,8 +9,7 @@ ms.author: rifox
 
 ## Record calls
 
-> [!NOTE]
-> This API is provided as a preview for developers and might change based on feedback that we receive. Don't use this API in a production environment. To use this API, use the beta release of the Azure Communication Services Calling Android SDK.
+[!INCLUDE [Public Preview Disclaimer](../../../../includes/Public-Preview-Note-android.md)]
 
 Call recording is an extended feature of the core `Call` object.
 
@@ -70,3 +69,22 @@ try {
 ```
 
 When you stop recording from the server, the event `handleCallOnIsRecordingChanged` is triggered and the value of `callRecordingFeature.isRecordingActive()` is `false`.
+
+## Explicit Consent
+[!INCLUDE [Public Preview Disclaimer](../../../../includes/Public-Preview-Note-android.md)]
+
+When your Teams meeting or call is configured to require explicit consent for recording and transcription, you're required to collect consent from all participants in the call before you can record them. You can provide consent proactively when joining the meeting or reactively when the recording starts. Until explicit consent is given, participants' audio, video, and screen sharing will be disabled during recording.
+
+You can check if the meeting recording requires explicit consent by property `isTeamsConsentRequired`. If the value is set to `true`, then explicit consent is required for the `call`.
+
+```java
+boolean isConsentRequired = callRecordingFeature.isTeamsConsentRequired();
+```
+
+If you have already obtained the user's consent for recording, you can call `grantTeamsConsent()` method to indicate explicit consent to the service. This consent is valid for one `call` session only and users need to provide consent again if they rejoin the meeting.
+
+```java
+callRecordingFeature.grantTeamsConsent();
+```
+
+Attempts to enable audio, video, or screen sharing fail when recording is active, explicit consent is required but isn't yet given. You can recognize this situation by checking property `reason` of class `ParticipantCapabilities` for [capabilities](../../capabilities.md) `turnVideoOn`, `unmuteMic` and `shareScreen`. You can find those [capabilities](../../capabilities.md) in the feature `call.feature(Features.Capabilities)`. Those [capabilities](../../capabilities.md) would return reason `ExplicitConsentRequired` as users need to provide explicit consent.

articles/communication-services/how-tos/calling-sdk/includes/record-calls/record-calls-ios.md

@@ -8,9 +8,8 @@ ms.author: rifox
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-ios.md)]
 
 ## Record calls
+[!INCLUDE [Public Preview Disclaimer](../../../../includes/Public-Preview-Note-ios.md)]
 
-> [!NOTE]
-> This API is provided as a preview for developers and might change based on feedback that we receive. Don't use this API in a production environment. To use this API, use the beta release of the Azure Communication Services Calling iOS SDK.
 
 Call recording is an extended feature of the core `Call` object.
 
@@ -59,3 +58,22 @@ let serverCallId = call.info.getServerCallId(){ (serverId, error) in }
 ```
 
 When you stop recording from the server, the event `didChangeRecordingState` is triggered and the value of `recordingFeature.isRecordingActive` is `false`.
+
+## Explicit Consent
+[!INCLUDE [Public Preview Disclaimer](../../../../includes/Public-Preview-Note-ios.md)]
+
+When your Teams meeting or call is configured to require explicit consent for recording and transcription, you're required to collect consent from all participants in the call before you can record them. You can provide consent proactively when joining the meeting or reactively when the recording starts. Until explicit consent is given, participants' audio, video, and screen sharing will be disabled during recording.
+
+You can check if the meeting recording requires explicit consent by property `isTeamsConsentRequired`. If the value is set to `true`, then explicit consent is required for the `call`.
+
+```swift
+let isConsentRequired = recordingFeature.isTeamsConsentRequired;
+```
+
+If you have already obtained the user's consent for recording, you can call `grantTeamsConsent()` method to indicate explicit consent to the service. This consent is valid for one `call` session only and users need to provide consent again if they rejoin the meeting.
+
+```swift
+recordingFeature.grantTeamsConsent();
+```
+
+Attempts to enable audio, video, or screen sharing fail when recording is active, explicit consent is required but isn't yet given. You can recognize this situation by checking property `reason` of class `ParticipantCapabilities` for [capabilities](../../capabilities.md) `turnVideoOn`, `unmuteMic` and `shareScreen`. You can find those [capabilities](../../capabilities.md) in the feature `call.feature(Features.Capabilities)`. Those [capabilities](../../capabilities.md) would return reason `ExplicitConsentRequired` as users need to provide explicit consent.

articles/communication-services/how-tos/calling-sdk/includes/record-calls/record-calls-windows.md

@@ -31,3 +31,22 @@ private async void Call__OnIsRecordingActiveChanged(object sender, PropertyChang
 
 recordingFeature.IsRecordingActiveChanged += Call__OnIsRecordingActiveChanged;
 ```
+
+## Explicit Consent
+[!INCLUDE [Public Preview Disclaimer](../../../../includes/Public-Preview-Note-windows.md)]
+
+When your Teams meeting or call is configured to require explicit consent for recording and transcription, you're required to collect consent from all participants in the call before you can record them. You can provide consent proactively when joining the meeting or reactively when the recording starts. Until explicit consent is given, participants' audio, video, and screen sharing will be disabled during recording.
+
+You can check if the meeting recording requires explicit consent by property `isTeamsConsentRequired`. If the value is set to `true`, then explicit consent is required for the `call`.
+
+```csharp
+boolean isConsentRequired = recordingFeature.isTeamsConsentRequired;
+```
+
+If you have already obtained the user's consent for recording, you can call `grantTeamsConsent()` method to indicate explicit consent to the service. This consent is valid for one `call` session only and users need to provide consent again if they rejoin the meeting.
+
+```csharp
+recordingFeature.grantTeamsConsent();
+```
+
+Attempts to enable audio, video, or screen sharing fail when recording is active, explicit consent is required but isn't yet given. You can recognize this situation by checking property `reason` of class `ParticipantCapabilities` for [capabilities](../../capabilities.md) `turnVideoOn`, `unmuteMic` and `shareScreen`. You can find those [capabilities](../../capabilities.md) in the feature `call.feature(Features.Capabilities)`. Those [capabilities](../../capabilities.md) would return reason `ExplicitConsentRequired` as users need to provide explicit consent.

articles/communication-services/how-tos/calling-sdk/record-calls.md

@@ -90,8 +90,8 @@ The following table shows the minimum version of SDKs that support individual AP
 |------------|-----|--------|-----|--------|---------|------------|---------|
 | Get notification that recording started or stopped | 1.0.0, 1.25.3-beta.1 | 1.0.0, 1.15.0-beta.1 | 2.0.0, 2.1.0-beta.1 | 1.0.0, 1.15.0-beta.1 | 2.0.0, 1.2.0-beta.1 | 1.0.0, 1.15.0-beta.1 | 1.0.0, 1.0.0-beta.31 |
 | Get state of recording | 1.0.0, 1.25.3-beta.1 | 1.0.0, 1.15.0-beta.1 | 2.0.0, 2.1.0-beta.1 | 1.0.0, 1.15.0-beta.1 | 2.0.0, 1.2.0-beta.1 | 1.0.0, 1.15.0-beta.1 | 1.0.0, 1.0.0-beta.31 |
-| Learn whether explicit consent is required | 1.31.2, 1.32.1-beta.1 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| Give explicit consent for being recorded | 1.31.2, 1.32.1-beta.1 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| Learn whether explicit consent is required  | 1.31.2, 1.32.1-beta.1 | ❌ | 2.16.0-beta.1  | ❌ | 2.14.0-beta.1  | ❌ | 1.12.0-beta.1 |
+| Give explicit consent for being recorded | 1.31.2, 1.32.1-beta.1 | ❌ | 2.16.0-beta.1  | ❌ | 2.14.0-beta.1  | ❌ | 1.12.0-beta.1 |
 
 ## Next steps
 

articles/communication-services/includes/Public-Preview-Note-ios.md

@@ -0,0 +1,2 @@
+> [!NOTE]
+> This API is provided as a preview for developers and might change based on feedback that we receive. Don't use this API in a production environment. To use this API, use the beta release of the Azure Communication Services Calling iOS SDK.

articles/communication-services/includes/Public-Preview-Note-windows.md

@@ -0,0 +1,2 @@
+> [!NOTE]
+> This API is provided as a preview for developers and might change based on feedback that we receive. Don't use this API in a production environment. To use this API, use the beta release of the Azure Communication Services Calling Windows SDK.