Skip to content

Commit 24357c3

Browse files
authored
Merge pull request #286605 from tomaschladek/patch-51
Update capabilities.md
2 parents 4df7c69 + 371a215 commit 24357c3

File tree

1 file changed

+20
-3
lines changed

1 file changed

+20
-3
lines changed

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

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Get local user capabilities
33
titleSuffix: An Azure Communication Services how-to guide
4-
description: Use Azure Communication Services SDKs to get capabilities of the local user in a call.
4+
description: Use Azure Communication Services SDK to get capabilities of the local user in a call.
55
author: elavarasid
66
ms.author: elavarasid
77
ms.service: azure-communication-services
@@ -12,7 +12,7 @@ ms.custom: template-how-to
1212
zone_pivot_groups: acs-plat-web-ios-android-windows
1313
---
1414
# Observe user's capabilities
15-
Do I have permission to turn on video, do I have permission to turn on mic, 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.
15+
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.
1616

1717
## Prerequisites
1818
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
@@ -36,9 +36,26 @@ Do I have permission to turn on video, do I have permission to turn on mic, do I
3636
[!INCLUDE [Capabilities iOS](./includes/capabilities/capabilities-ios.md)]
3737
::: zone-end
3838

39-
## Supported Calltype
39+
## Supported call types
4040
The feature is currently supported only for Azure Communication Services Rooms call type and teams meeting call type
4141

42+
## Reasons
43+
44+
The following table provides additional information about why action isn't available and provides tips how to make the action available.
45+
46+
| Reason | Description | Resolution |
47+
|---------------------------------------|------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
48+
| Capable | Action is allowed. | |
49+
| 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. |
50+
| 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. |
51+
| 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. |
52+
| RoleRestricted | Assigned role blocks the action. | Promote user to different role to make the action available. |
53+
| 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. |
54+
| MeetingRestricted | Teams meeting option blocks the action. | Teams meeting organizer or co-organizer needs to change meeting option to enable this action. |
55+
| NotInitialized | The capabilities feature isn't initialized yet. | Subscribe to event `capabilitiesChanged` on `this.call.feature(Features.Capabilities)` to know when capability is initialized. |
56+
| NotCapable | User type blocks the action. | The action is only allowed to specific type of identity. Enable this action by using Microsoft 365 identity. |
57+
| 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. |
58+
4259
## Next steps
4360
- [Learn how to manage video](./manage-video.md)
4461
- [Learn how to manage calls](./manage-calls.md)

0 commit comments

Comments
 (0)