Merge pull request #298905 from vac0224/vc-manage-lobby-2025-04-30

ttorble · web-flow · commit 4c5c34a2462b · 2025-05-12T08:49:41.000+01:00
Lobby and Capabilities
diff --git a/articles/communication-services/how-tos/calling-sdk/capabilities.md b/articles/communication-services/how-tos/calling-sdk/capabilities.md
@@ -1,5 +1,5 @@
 ---
-title: Get local user capabilities
+title: Get local capabilities
 titleSuffix: An Azure Communication Services how-to guide
 description: Use Azure Communication Services SDK to get capabilities of the local user in a call.
 author: elavarasid
@@ -11,10 +11,13 @@ ms.date: 03/24/2023
 ms.custom: template-how-to
 zone_pivot_groups: acs-plat-web-ios-android-windows
 ---
-# Observe user's capabilities
+
+# Get local capabilities
+
 Do I have permission to turn on video, do I have permission to turn on mic, do I have permission to share screen? Those permissions are examples of participant capabilities that you can learn from the capabilities API. Learning the capabilities can help build a user interface that only shows the buttons related to the actions the local user has permissions to.
 
 ## Prerequisites
+
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 - A deployed Communication Services resource. [Create a Communication Services resource](../../quickstarts/create-communication-resource.md).
 - A user access token to enable the calling client. For more information, see [Create and manage access tokens](../../quickstarts/identity/access-tokens.md).
@@ -37,26 +40,36 @@ Do I have permission to turn on video, do I have permission to turn on mic, do I
 ::: zone-end
 
 ## Supported call types
-The feature is currently supported only for Azure Communication Services Rooms call type and teams meeting call type
+
+The following tables define the ability to get capabilities using the Azure Communication Services Calling SDK.
+
+### Identities and call types
+
+| Identities | Teams meeting | Room | 1:1 call | Group call | 1:1 Teams interop call | Group Teams interop call |
+| --- | --- | --- | --- | --- | --- | --- |
+| Communication Services user | ✔️ | ✔️ |  |  |  |  |
+| Microsoft 365 user | ✔️ | ✔️ |  |  |  |  |
 
 ## Reasons
 
 The following table provides additional information about why action isn't available and provides tips how to make the action available. 
 
-| Reason                                | Description                                                      | Resolution                                                                                                                                                                                                                                                                         |
-|---------------------------------------|------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Capable                               | Action is allowed.                                               |                                                                                                                                                                                                                                                                                    |
-| CapabilityNotApplicableForTheCallType | Call type blocks the action.                                     | Consider other type of call if you need this action. The call types are: 1:1 call, group call, 1:1 Teams interop call, 1:1 Teams interop group call, Room, and Meeting.                                                                                                            |
-| ClientRestricted                      | The runtime environment is blocking this action                  | Unblock the action on your device by changing operating system, browsers, platform, or hardware. You can find supported environment in our documentation.                                                                                                                          |
-| UserPolicyRestricted                  | Microsoft 365 user's policy blocks the action.                   | Enable this action by changing policy that is assigned to the organizer of the meeting, initiator of the call or Microsoft 365 user using ACS SDK. The target user depends on the type of action. Learn more about Teams policy in Teams. Teams administrator can change policies. |
-| RoleRestricted                        | Assigned role blocks the action.                                 | Promote user to different role to make the action available.                                                                                                                                                                                                                       |
-| FeatureNotSupported                   | The capabilities feature isn't supported in this call type.      | Let us know in Azure Feedback channel that you would like to have this feature available for this call type.                                                                                                                                                                       |
-| MeetingRestricted                     | Teams meeting option blocks the action.                          | Teams meeting organizer or co-organizer needs to change meeting option to enable this action.                                                                                                                                                                                      |
-| NotInitialized                        | The capabilities feature isn't initialized yet.                  | Subscribe to event `capabilitiesChanged` on `this.call.feature(Features.Capabilities)` to know when capability is initialized.                                                                                                                                                     |
-| NotCapable                            | User type blocks the action.                                     | The action is only allowed to specific type of identity. Enable this action by using Microsoft 365 identity.                                                                                                                                                                       |
-| TeamsPremiumLicenseRestricted         | Microsoft 365 user needs to have Teams Premium license assigned. | Enable this action by assigning Teams Premium license to the Teams meeting organizer or the Microsoft 365 user using SDK. The target user depends on the type of action. Microsoft 365 admin can assign required license.                                                          |
-| ExplicitConsentRequired               | Consent is required to allow the action.   | Provide the consent for recording or transcription by calling method `grantTeamsConsent()` under `this.call.feature(Features.Recording)` or `this.call.feature(Features.Transcription)` .|
+| Reason | Description | Resolution |
+| --- | --- | --- |
+| Capable | Action is enabled. | |
+| CapabilityNotApplicableForTheCallType | Call type blocks the action. | Consider other type of call if you need this action. The call types are: 1:1 call, group call, 1:1 Teams interop call, 1:1 Teams interop group call, Room, and Meeting. |
+| ClientRestricted | The runtime environment is blocking this action | Unblock the action on your device by changing operating system, browsers, platform, or hardware. You can find supported environment in our documentation. |
+| UserPolicyRestricted | Microsoft 365 user's policy blocks the action. | Enable this action by changing policy that is assigned to the organizer of the meeting, initiator of the call or Microsoft 365 user using ACS SDK. The target user depends on the type of action. Learn more about Teams policy in Teams. Teams administrator can change policies. |
+| RoleRestricted | Assigned role blocks the action. | Promote user to different role to make the action available. |
+| FeatureNotSupported | The capabilities feature isn't supported in this call type. | Let us know in Azure Feedback channel that you would like to have this feature available for this call type. |
+| MeetingRestricted | Teams meeting option blocks the action. | Teams meeting organizer or co-organizer needs to change meeting option to enable this action. |
+| NotInitialized | The capabilities feature isn't initialized yet. | Subscribe to event `capabilitiesChanged` on `this.call.feature(Features.Capabilities)` to know when capability is initialized. |
+| NotCapable | User type blocks the action. | The action is only enabled for specific identities. Enable this action by using Microsoft 365 identity. |
+| TeamsPremiumLicenseRestricted | Microsoft 365 user needs to have Teams Premium license assigned. | Enable this action by assigning Teams Premium license to the Teams meeting organizer or the Microsoft 365 user using SDK. The target user depends on the type of action. Microsoft 365 admin can assign required license. |
+| ExplicitConsentRequired | Consent is required to allow the action. | Provide the consent for recording or transcription by calling method `grantTeamsConsent()` under `this.call.feature(Features.Recording)` or `this.call.feature(Features.Transcription)` .|
+
 ## Next steps
+
 - [Learn how to manage video](./manage-video.md)
 - [Learn how to manage calls](./manage-calls.md)
 - [Learn how to record calls](./record-calls.md)
diff --git a/articles/communication-services/how-tos/calling-sdk/includes/capabilities/capabilities-android.md b/articles/communication-services/how-tos/calling-sdk/includes/capabilities/capabilities-android.md
@@ -7,19 +7,21 @@ ms.author: zehangzheng
 ---
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-android.md)]
 
-Capabilities feature is an extended feature of the core `Call` API and allows you to obtain the capabilities of the local participant in the current call.
+The ability to view capabilities is an extended feature of the core `Call` API. It enables you to obtain the capabilities of the local participant in the current call.
 
-The feature allows you to register for an event listener, to listen to capability changes.
+The feature enables you to register for an event listener to listen for capability changes.
 
 In order to use the Capabilities call feature for Windows, the first step is to obtain the Capabilities feature API object:
 
-## Obtaining capabilities feature
+## Get the capabilities feature
+
 ```java
 private CapabilitiesCallFeature capabilitiesCallFeature;
 capabilitiesCallFeature = call.feature(Features.CAPABILITIES);
 ```
 
 ## Get the capabilities of the local participant
+
 Capabilities object has the capabilities of the local participants and is of type `ParticipantCapability`. Properties of Capabilities include:
 
 - *isAllowed* indicates if a capability can be used.
@@ -30,6 +32,7 @@ List<ParticipantCapability> capabilities = capabilitiesCallFeature.getCapabiliti
 ```
 
 ## Subscribe to `capabilitiesChanged` event
+
 ```java
 
 capabilitiesCallFeature.addOnCapabilitiesChangedListener(this::OnCapabilitiesChanged);
@@ -46,7 +49,8 @@ private void OnCapabilitiesChanged(CapabilitiesChangedEvent args)
 ```
 
 ## Capabilities Exposed
-- *TurnVideoOn*: Ability to turn video on
+
+- *TurnVideoOn*: Ability to turn on video
 - *UnmuteMicrophone*: Ability to unmute microphone
 - *ShareScreen*: Ability to share screen
 - *RemoveParticipant*: Ability to remove a participant
@@ -61,4 +65,4 @@ private void OnCapabilitiesChanged(CapabilitiesChangedEvent args)
 - *CustomBackground*: Ability to apply a custom background
 - *StartLiveCaptions*: Ability to start live captions
 - *RaiseHand*: Ability to raise hand
-- *MuteOthers*: Ability to soft mute remote participant(s) in the meeting 
+- *MuteOthers*: Ability to soft mute remote participants in the meeting 
diff --git a/articles/communication-services/how-tos/calling-sdk/includes/capabilities/capabilities-ios.md b/articles/communication-services/how-tos/calling-sdk/includes/capabilities/capabilities-ios.md
@@ -7,18 +7,20 @@ ms.author: zehangzheng
 ---
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-ios.md)]
 
-Capabilities feature is an extended feature of the core `Call` API and allows you to obtain the capabilities of the local participant in the current call.
+The ability to view capabilities is an extended feature of the core `Call` API. It enables you to obtain the capabilities of the local participant in the current call.
 
-The feature allows you to register for an event listener, to listen to capability changes.
+The feature enables you to register for an event listener to listen for capability changes.
 
-In order to use the Capabilities call feature for Windows, the first step is to obtain the Capabilities feature API object:
+To use the Capabilities call feature for Windows, the first step is to obtain the Capabilities feature API object:
+
+## Get the capabilities feature
 
-## Obtaining capabilities feature
 ```swift
 let capabilitiesCallFeature =call.feature(Features.capabilities)
 ```
 
 ## Get the capabilities of the local participant
+
 Capabilities object has the capabilities of the local participants and is of type `ParticipantCapability`. Properties of Capabilities include:
 
 - *isAllowed* indicates if a capability can be used.
@@ -29,6 +31,7 @@ var capabilities = capabilitiesCallFeature.capabilities
 ```
 
 ## Subscribe to `capabilitiesChanged` event
+
 ```swift
 
 capabilitiesCallFeature.delegate = CapabilitiesCallDelegate()
@@ -43,7 +46,8 @@ public class CapabilitiesCallDelegate : CapabilitiesCallFeatureDelegate
 ```
 
 ## Capabilities Exposed
-- *TurnVideoOn*: Ability to turn video on
+
+- *TurnVideoOn*: Ability to turn on video
 - *UnmuteMicrophone*: Ability to unmute microphone
 - *ShareScreen*: Ability to share screen
 - *RemoveParticipant*: Ability to remove a participant
@@ -58,4 +62,4 @@ public class CapabilitiesCallDelegate : CapabilitiesCallFeatureDelegate
 - *CustomBackground*: Ability to apply a custom background
 - *StartLiveCaptions*: Ability to start live captions
 - *RaiseHand*: Ability to raise hand
-- *MuteOthers*: Ability to soft mute remote participant(s) in the meeting 
+- *MuteOthers*: Ability to soft mute remote participants in the meeting 
diff --git a/articles/communication-services/how-tos/calling-sdk/includes/capabilities/capabilities-web.md b/articles/communication-services/how-tos/calling-sdk/includes/capabilities/capabilities-web.md
@@ -7,17 +7,18 @@ ms.author: elavarasid
 ---
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-web.md)]
 
-Capabilities feature is an extended feature of the core `Call` API and allows you to obtain the capabilities of the local participant in the current call.
+The ability to view capabilities is an extended feature of the core `Call` API. It enables you to obtain the capabilities of the local participant in the current call.
 
+The feature enables you to register for an event listener to listen for capability changes.
 
-The feature allows you to register for an event listener, to listen to capability changes.
+## Get the capabilities feature
 
-**Register to capabilities feature:**
 >```js
 >const capabilitiesFeature = this.call.feature(Features.Capabilities);
 >```
 
-**Get the capabilities of the local participant:**
+## Get the capabilities of the local participant
+
 Capabilities object has the capabilities of the local participants and is of type `ParticipantCapabilities`. Properties of Capabilities include:
 
 - *isPresent* indicates if a capability is present.
@@ -28,6 +29,7 @@ const capabilities =  capabilitiesFeature.capabilities;
 ```
 
 **Subscribe to `capabilitiesChanged` event:**
+
 ```js
 capabilitiesFeature.on('capabilitiesChanged', (capabilitiesChangeInfo) => {
     for (const [key, value] of Object.entries(capabilitiesChangeInfo.newValue)) {
@@ -71,7 +73,8 @@ capabilitiesFeature.on('capabilitiesChanged', (capabilitiesChangeInfo) => {
 });
 ```
 
-**Capabilities Exposed**
+## Capabilities Exposed
+
 - *turnVideoOn*: Ability to turn on video
 - *unmuteMic*: Ability to send audio
 - *shareScreen*: Ability to share screen
@@ -86,7 +89,7 @@ capabilitiesFeature.on('capabilitiesChanged', (capabilitiesChangeInfo) => {
 - *startLiveCaptions*: Ability to start live captions (beta only)
 - *stopLiveCaptions*: Ability to stop live captions (beta only)
 - *raiseHand*: Ability to raise hand (beta only)
-- *muteOthers*: Ability to soft mute remote participant(s) in the meeting 
+- *muteOthers*: Ability to soft mute remote participants in the meeting 
 - *reaction*: Ability to react in the meeting (beta only)
 - *viewAttendeeNames*: Ability to view attendee names in the meeting
 - *forbidOthersAudio*: Ability to forbid attendees' audio in the meeting or group call
diff --git a/articles/communication-services/how-tos/calling-sdk/includes/capabilities/capabilities-windows.md b/articles/communication-services/how-tos/calling-sdk/includes/capabilities/capabilities-windows.md
@@ -7,19 +7,21 @@ ms.author: zehangzheng
 ---
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-windows.md)]
 
-Capabilities feature is an extended feature of the core `Call` API and allows you to obtain the capabilities of the local participant in the current call.
+The ability to view capabilities is an extended feature of the core `Call` API. It enables you to obtain the capabilities of the local participant in the current call.
 
-The feature allows you to register for an event listener, to listen to capability changes.
+The feature enables you to register for an event listener to listen for capability changes.
 
-In order to use the Capabilities call feature for Windows, the first step is to obtain the Capabilities feature API object:
+To use the Capabilities call feature for Windows, the first step is to obtain the Capabilities feature API object:
+
+## Get the capabilities feature
 
-## Obtaining capabilities feature
 ```C#
 private CapabilitiesCallFeature capabilitiesCallFeature;
 capabilitiesCallFeature = call.Features.Capabilities;
 ```
 
 ## Get the capabilities of the local participant
+
 Capabilities object has the capabilities of the local participants and is of type `ParticipantCapability`. Properties of Capabilities include:
 
 - *isAllowed* indicates if a capability can be used.
@@ -30,6 +32,7 @@ var capabilities = capabilitiesCallFeature.Capabilities;
 ```
 
 ## Subscribe to `capabilitiesChanged` event
+
 ```C#
 capabilitiesCallFeature.CapabilitiesChanged += Call__OnCapabilitiesChangedAsync;
 
@@ -45,7 +48,8 @@ private async void Call__OnCapabilitiesChangedAsync(object sender, CapabilitiesC
 ```
 
 ## Capabilities Exposed
-- *TurnVideoOn*: Ability to turn video on
+
+- *TurnVideoOn*: Ability to turn on video
 - *UnmuteMicrophone*: Ability to unmute microphone
 - *ShareScreen*: Ability to share screen
 - *RemoveParticipant*: Ability to remove a participant
@@ -60,4 +64,4 @@ private async void Call__OnCapabilitiesChangedAsync(object sender, CapabilitiesC
 - *CustomBackground*: Ability to apply a custom background
 - *StartLiveCaptions*: Ability to start live captions
 - *RaiseHand*: Ability to raise hand
-- *MuteOthers*: Ability to soft mute remote participant(s) in the meeting 
+- *MuteOthers*: Ability to soft mute remote participants in the meeting 
diff --git a/articles/communication-services/how-tos/calling-sdk/includes/install-sdk/install-sdk-web.md b/articles/communication-services/how-tos/calling-sdk/includes/install-sdk/install-sdk-web.md
@@ -44,7 +44,7 @@ const callAgent = await callClient.createCallAgent(tokenCredential, {displayName
 const deviceManager = await callClient.getDeviceManager()
 ```
 
-### How to best manage SDK connectivity to Microsoft infrastructure
+### Manage SDK connectivity to Microsoft infrastructure
 
 The `Call Agent` instance helps you manage calls (to join or start calls). In order to work your calling SDK needs to connect to Microsoft infrastructure to get notifications of incoming calls and coordinate other call details. Your `Call Agent` has two possible states:
 
diff --git a/articles/communication-services/how-tos/calling-sdk/lobby.md b/articles/communication-services/how-tos/calling-sdk/lobby.md
