Merge pull request #232028 from elavarasidc/patch-1

Calling web - Capabilities feature -how to

Author: ttorble

articles/communication-services/how-tos/calling-sdk/capabilities.md

@@ -0,0 +1,28 @@
+---
+title: Get local user capabilities
+titleSuffix: An Azure Communication Services how-to guide
+description: Use Azure Communication Services SDKs to get capabilities of the local user in a call.
+author: elavarasid
+ms.author: elavarasid
+ms.service: azure-communication-services
+ms.subservice: calling
+ms.topic: how-to
+ms.date: 03/24/2023
+ms.custom: template-how-to
+---
+# Observe user's capabilities
+Do I have permission to turn video on, do I have permission to turn mic on, do I have permission to share screen? Those are some 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).
+- Optional: Complete the quick start to [add voice calling to your application](../../quickstarts/voice-video-calling/getting-started-with-calling.md)
+
+## Supported Platform - Web
+[!INCLUDE [Capabilities JavaScript](./includes/capabilities/capabilities-web.md)]
+
+## 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)

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

@@ -0,0 +1,46 @@
+---
+author: elavarasid
+ms.service: azure-communication-services
+ms.topic: include
+ms.date: 03/24/2023
+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 feature allows you to register for an event listener, to listen to capability changes.
+
+**Register to capabilities feature:**
+>```js
+>const capabilitiesFeature = this.call.feature(Features.Capabilities);
+>```
+
+**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` represent if a capability is present.
+- `reason` capability resolution reason.
+
+>```js
+>const capabilities =  capabilitiesFeature.capabilities;
+>```
+
+**Subscribe to `capabilitiesChanged` event:**
+>```js
+>capabilitiesFeature.on('capabilitiesChanged', () => {
+>  const updatedCapabilities  = capabilitiesFeature.capabilities;
+>  // If screen share capability has changed then update the state to refresh UI and disable share screen button
+>  if (this.state.canShareScreen != updatedCapabilities.shareScreen.isPresent) {
+>    this.setState({ canShareScreen: updatedCapabilities.shareScreen.isPresent });
+>  }
+>});
+>```
+
+**Capabilities Exposed**
+> - *manageBreakOutRoom*:	      Ability to manage break out room
+> - *muteUnmuteMic*:	          Ability to Mute Unmute Mic
+> - *removeParticipant*:	      Ability to remove a participant
+> - *shareApplication*:	        Ability to share an application
+> - *shareBrowserTab*:	        Ability to share a browser tab