Skip to content

Commit 444243b

Browse files
committed
spotlight, transcription, and dominant speaker
1 parent c2e6625 commit 444243b

18 files changed

+101
-93
lines changed
Lines changed: 27 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
---
2-
title: Display call transcription state on the client
3-
titleSuffix: An Azure Communication Services how-to guide
2+
title: Show call transcription state on the client
3+
titleSuffix: An Azure Communication Services article
44
description: Use Azure Communication Services SDKs to display the call transcription state
55
author: tophpalmer
66
ms.author: chpalm
77
ms.service: azure-communication-services
88
ms.subservice: calling
99
ms.topic: how-to
10-
ms.date: 08/10/2021
10+
ms.date: 06/15/2025
1111
ms.custom: template-how-to
1212
zone_pivot_groups: acs-plat-web-ios-android-windows
1313
---
1414

15-
# Display call transcription state on the client
15+
# Show call transcription state on the client
1616

17-
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. You can check the transcription state if transcription started before you joined the call or meeting. You can provide explicit consent to transcription if a meeting or call requires it, and you have already collected it.
17+
You need to collect consent from all participants in the call before you can transcribe them. Microsoft Teams enables users to start transcription in the meetings or calls. You receive an event when transcription starts. You can check the transcription state if transcription started before you joined the call or meeting. You can provide explicit consent to transcription if a meeting or call requires it, and you already collected it.
1818

1919
## Prerequisites
2020

@@ -24,35 +24,39 @@ You need to collect consent from all participants in the call before you can tra
2424
- Optional: Complete the quickstart to [add voice calling to your application](../../quickstarts/voice-video-calling/getting-started-with-calling.md)
2525

2626
## Support
27+
2728
The following tables define support of call transcription in Azure Communication Services.
2829

2930
## Identities and call types
31+
3032
The following tables show support of transcription for specific call type and identity.
3133

32-
|Identities | Teams meeting | Room | 1:1 call | Group call | 1:1 Teams interop call | Group Teams interop call |
33-
|-----------------------------|---------------|------|----------|------------|------------------------|--------------------------|
34-
|Communication Services user | ✔️ | | | | ✔️ | ✔️ |
35-
|Microsoft 365 user | ✔️ | | | | ✔️ | ✔️ |
34+
|Identities | Teams meeting | Room | 1:1 call | Group call | 1:1 Teams interop call | Group Teams interop call |
35+
| --- | --- | --- | --- | --- | --- | --- |
36+
|Communication Services user | ✔️ | | | | ✔️ | ✔️ |
37+
|Microsoft 365 user | ✔️ | | | | ✔️ | ✔️ |
3638

3739
## Operations
40+
3841
The following tables show support of individual APIs in calling SDK to individual identity types.
3942

40-
|Operations | Communication Services user | Microsoft 365 user |
41-
|-----------------------------|------------------------------|-------------------|
42-
|Get event that transcription has started | ✔️ | ✔️ |
43-
|Get transcription state | ✔️ | ✔️ |
44-
|Start or stop transcription | | |
45-
|Learn whether explicit consent is required | ✔️[1] | ✔️[1] |
46-
|Give explicit consent for being transcribed | ✔️[1] | ✔️[1] |
43+
|Operations | Communication Services user | Microsoft 365 user |
44+
| --- | --- | --- |
45+
|Get event that transcription started | ✔️ | ✔️ |
46+
|Get transcription state | ✔️ | ✔️ |
47+
|Start or stop transcription | | |
48+
|Learn whether explicit consent is required | ✔️[1] | ✔️[1] |
49+
|Give explicit consent for being transcribed | ✔️[1] | ✔️[1] |
4750

48-
[1] This functionality is available only in Teams meetings and group Teams interoperability calls.
51+
[1] This function is available only in Teams meetings and group Teams interoperability calls.
4952

5053
## SDKs
54+
5155
The following tables show support of transcription in individual Azure Communication Services SDKs.
5256

53-
| Platforms | Web | Web UI | iOS | iOS UI | Android | Android UI | Windows |
57+
| Platforms | Web | Web UI | iOS | iOS UI | Android | Android UI | Windows |
5458
|-------------|-----|--------|-----|--------|---------|------------|---------|
55-
|Is Supported | ✔️ | ✔️[1] | ✔️[1] | ✔️[1]| ✔️[1]| ✔️[1]| ✔️[1] |
59+
|Is Supported | ✔️ | ✔️[1] | ✔️[1] | ✔️[1]| ✔️[1]| ✔️[1]| ✔️[1] |
5660

5761
[1] These SDKs don't support explicit consent.
5862

@@ -78,12 +82,13 @@ The following table shows the minimum version of SDKs that support individual AP
7882

7983
| Operations | Web | Web UI | iOS | iOS UI | Android | Android UI | Windows |
8084
|------------|-----|--------|-----|--------|---------|------------|---------|
81-
| 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 |
85+
| Get event that transcription 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 |
8286
| 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 |
83-
| 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 |
84-
| 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 |
87+
| 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 |
88+
| 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 |
8589

8690
## Next steps
91+
8792
- [Learn how to manage video](./manage-video.md)
8893
- [Learn how to manage calls](./manage-calls.md)
8994
- [Learn how to record calls](./record-calls.md)

articles/communication-services/how-tos/calling-sdk/dominant-speaker.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,22 @@
11
---
2-
title: Get active speakers
3-
titleSuffix: An Azure Communication Services how-to guide
2+
title: Show active speakers
3+
titleSuffix: An Azure Communication Services article
44
description: Use Azure Communication Services SDKs to render the active speakers in a call.
55
author: jsaurezlee-msft
66
ms.author: jsaurezlee
77
ms.service: azure-communication-services
88
ms.subservice: calling
99
ms.topic: how-to
10-
ms.date: 08/10/2021
10+
ms.date: 06/15/2025
1111
ms.custom: template-how-to
1212
zone_pivot_groups: acs-plat-web-ios-android-windows
1313

1414
#Customer intent: As a developer, I want to get a list of active speakers within a call.
1515
---
1616

17-
# Get active speakers within a call
17+
# Show active speakers within a call
1818

19-
20-
During an active call, you may want to get a list of active speakers in order to render or display them differently. Here's how.
19+
During an active call, you might want to get a list of active speakers in order to render or display them differently. Here's how.
2120

2221
## Prerequisites
2322

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

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22
author: probableprime
33
ms.service: azure-communication-services
44
ms.topic: include
5-
ms.date: 09/08/2021
5+
ms.date: 06/15/2025
66
ms.author: rifox
77
---
88
[!INCLUDE [Install SDK](../install-sdk/install-sdk-android.md)]
99

1010
> [!WARNING]
11-
> Up until version 1.1.0 and beta release version 1.1.0-beta.1 of the Azure Communication Services Calling Android SDK has the `isTranscriptionActive` and `addOnIsTranscriptionActiveChangedListener` are part of the `Call` object. For new beta releases, those APIs have been moved as an extended feature of `Call` just like described below.
11+
> Up until version 1.1.0 and beta release version 1.1.0-beta.1 of the Azure Communication Services Calling Android SDK has the `isTranscriptionActive` and `addOnIsTranscriptionActiveChangedListener` are part of the `Call` object. For new beta releases, those features are now as an extended feature of `Call` as described later in this article.
1212
1313
Call transcription is an extended feature of the core `Call` object. You first need to obtain the transcription feature object:
1414

@@ -33,19 +33,20 @@ callTranscriptionFeature.addOnIsTranscriptionActiveChangedListener(handleCallOnI
3333
```
3434

3535
## Explicit Consent
36+
3637
[!INCLUDE [Public Preview Disclaimer](../../../../includes/Public-Preview-Note-android.md)]
3738

38-
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.
39+
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 permit 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 is disabled during transcription.
3940

4041
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`.
4142

4243
```java
4344
boolean isTranscriptionConsentRequired = callTranscriptionFeature.isTeamsConsentRequired();
4445
```
4546

46-
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.
47+
If you 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.
4748

4849
```java
4950
callTranscriptionFeature.grantTeamsConsent();
5051
```
51-
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.
52+
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

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22
author: probableprime
33
ms.service: azure-communication-services
44
ms.topic: include
5-
ms.date: 09/08/2021
5+
ms.date: 06/15/2025
66
ms.author: rifox
77
---
88
[!INCLUDE [Install SDK](../install-sdk/install-sdk-ios.md)]
99

1010
> [!WARNING]
11-
> Up until version 1.1.0 and beta release version 1.1.0-beta.1 of the Azure Communication Services Calling iOS SDK has the `isTranscriptionActive` as part of the `Call` object and `didChangeTranscriptionState` is part of `CallDelegate` delegate. For new beta releases, those APIs have been moved as an extended feature of `Call` just like described below.
11+
> Up until version 1.1.0 and beta release version 1.1.0-beta.1 of the Azure Communication Services Calling iOS SDK has the `isTranscriptionActive` as part of the `Call` object and `didChangeTranscriptionState` is part of `CallDelegate` delegate. For new beta releases, those features are now as an extended feature of `Call` as described later in this article.
1212
1313
Call transcription is an extended feature of the core `Call` object. You first need to obtain the transcription feature object:
1414

@@ -35,17 +35,17 @@ public func transcriptionCallFeature(_ transcriptionCallFeature: TranscriptionCa
3535
## Explicit Consent
3636
[!INCLUDE [Public Preview Disclaimer](../../../../includes/Public-Preview-Note-ios.md)]
3737

38-
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.
38+
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 permit 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 is disabled during transcription.
3939

4040
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`.
4141

4242
```swift
4343
let isTranscriptionConsentRequired = callTranscriptionFeature.isTeamsConsentRequired;
4444
```
4545

46-
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.
46+
If you 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.
4747

4848
```swift
4949
callTranscriptionFeature.grantTeamsConsent();
5050
```
51-
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.
51+
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-web.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,14 @@
22
author: tomaschladek
33
ms.service: azure-communication-services
44
ms.topic: include
5-
ms.date: 08/08/2024
5+
ms.date: 06/15/2025
66
ms.author: tchladek
77
---
88

99
[!INCLUDE [Install SDK](../install-sdk/install-sdk-web.md)]
1010

1111
> [!WARNING]
12-
> 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.
12+
> 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 use Teams transcription in the calls and meetings, you need to upgrade your calling SDK to at least version 1.22.
1313
1414
## Call transcription
1515

@@ -41,17 +41,17 @@ callTranscriptionFeature.off('isTranscriptionActiveChanged', isTranscriptionActi
4141
```
4242

4343
## Explicit Consent
44-
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.
44+
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 permit 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 is disabled during transcription.
4545

4646
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`.
4747

4848
```js
4949
const isTranscriptionConsentRequired = callTranscriptionFeature.isTeamsConsentRequired;
5050
```
5151

52-
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.
52+
If you 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.
5353

5454
```js
5555
callTranscriptionFeature.grantTeamsConsent();
5656
```
57-
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.
57+
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.

0 commit comments

Comments
 (0)