Merge pull request #283591 from tomaschladek/tchladek_transcription

Tchladek transcription

Author: v-shils

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

@@ -9,17 +9,12 @@ ms.subservice: calling
 ms.topic: how-to 
 ms.date: 08/10/2021
 ms.custom: template-how-to
-zone_pivot_groups: acs-plat-ios-android-windows
-
-#Customer intent: As a developer, I want to display the call transcription state on the client.
+zone_pivot_groups: acs-plat-web-ios-android-windows
 ---
 
 # Display call transcription state on the client
 
-> [!NOTE]
-> Call transcription state is only available from Teams meetings. Currently there's no support for call transcription state for Azure Communication Services to Azure Communication Services calls.
-
-When using call transcription you may want to let your users know that a call is being transcribe. Here's how.
+You need to collect consent from all participants in the call before you can transcribe them. Microsoft Teams allows users to start transcription in the meetings or calls. You would receive event when transcription has started on you can check the transcription state, if transcription started before you joined the call or meeting.
 
 ## Prerequisites
 
@@ -28,6 +23,37 @@ When using call transcription you may want to let your users know that a call is
 - A user access token to enable the calling client. For more information, see [Create and manage access tokens](../../quickstarts/identity/access-tokens.md).
 - Optional: Complete the quickstart to [add voice calling to your application](../../quickstarts/voice-video-calling/getting-started-with-calling.md)
 
+## Support
+The following tables define support of call transcription in Azure Communication Services.
+
+## Identities and call types
+The following tables show support of transcription for specific call type and identity. 
+
+|Identities                   | Teams meeting | Room | 1:1 call | Group call | 1:1 Teams interop call | Group Teams interop call |
+|-----------------------------|---------------|------|----------|------------|------------------------|--------------------------|
+|Communication Services user	| ✔️	          |      |          |            |	  ✔️                  |	✔️                       |
+|Microsoft 365 user	          | ✔️	          |      |          |            |    ✔️                  | ✔️                      |
+
+## Operations
+The following tables show support of individual APIs in calling SDK to individual identity types. 
+
+|Operations                   | Communication Services user | Microsoft 365 user |
+|-----------------------------|------------------------------|-------------------|
+|Get event that transcription has started	| ✔️	| ✔️  |  		
+|Get transcription state	                | ✔️	| ✔️  | 
+|Start or stop transcription              | 	|  |
+
+## SDKs
+The following tables show support of transcription in individual Azure Communication Services SDKs.
+
+| Platforms   | Web | Web UI | iOS | iOS UI | Android | Android UI | Windows |
+|-------------|-----|--------|-----|--------|---------|------------|---------|
+|Is Supported | ✔️  |  ✔️   | ✔️ | ✔️     | ✔️     | ✔️         |  ✔️    |		
+
+::: zone pivot="platform-web"
+[!INCLUDE [Call transcription client-side Web](./includes/call-transcription/call-transcription-web.md)]
+::: zone-end
+
 ::: zone pivot="platform-android"
 [!INCLUDE [Call transcription client-side Android](./includes/call-transcription/call-transcription-android.md)]
 ::: zone-end

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

@@ -0,0 +1,41 @@
+---
+author: tomaschladek
+ms.service: azure-communication-services
+ms.topic: include
+ms.date: 08/08/2024
+ms.author: tchladek
+---
+
+[!INCLUDE [Install SDK](../install-sdk/install-sdk-web.md)]
+
+> [!WARNING]
+> Due to changes in Microsoft Teams, JavaScript calling SDKs with versions 1.21 and lower stops Teams transcription and blocks Teams users to start transcription. If you would like to leverage Teams transcription in the calls and meetings, you need to upgrade your calling SDK to at least version 1.22.
+
+## Call transcription 
+
+`Transcription` is an extended feature of the class `Call`. You first need to obtain the transcription feature API object
+
+```js
+const callTranscriptionFeature = call.feature(Features.Transcription);
+```
+
+You can check state of the transcription in the property `isTranscriptionActive`. If value is set to `true`, then transcription is active.
+
+```js
+const isTranscriptionActive = callTranscriptionFeature.isTranscriptionActive;
+```
+
+You can subscribe to event that is triggered when state of transcription changes:
+
+```js
+const isTranscriptionActiveChangedHandler = () => {
+  console.log(callTranscriptionFeature.isTranscriptionActive);
+};
+callTranscriptionFeature.on('isTranscriptionActiveChanged', isTranscriptionActiveChangedHandler);
+```
+
+You can unsubscribe from the event with the following code: 
+
+```js
+callTranscriptionFeature.off('isTranscriptionActiveChanged', isTranscriptionActiveChangedHandler);
+```