Merge pull request #284153 from cn0151/cnwankwo/spotlight_troubleshooting_table

Error table

Author: v-regandowner

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

@@ -7,26 +7,6 @@ ms.author: cnwankwo
 ---
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-web.md)]
 
-Communication Services or Microsoft 365 users can call the spotlight APIs based on role type and conversation type
-
-**In a one to one call or group call scenario, the following APIs are supported for both Communication Services and Microsoft 365 users**
-
-|APIs| Organizer | Presenter | Attendee |
-|----------------------------------------------|--------|--------|--------|
-| startSpotlight | ✔️ | ✔️  | ✔️ |
-| stopSpotlight | ✔️ | ✔️ | ✔️ |
-| stopAllSpotlight |  ✔️ | ✔️ | ✔️ |
-| getSpotlightedParticipants |  ✔️ | ✔️ | ✔️ |
-
-**For meeting scenario the following APIs are supported for both Communication Services and Microsoft 365 users**
-
-|APIs| Organizer | Presenter | Attendee |
-|----------------------------------------------|--------|--------|--------|
-| startSpotlight | ✔️ | ✔️  |  |
-| stopSpotlight | ✔️ | ✔️ | ✔️ |
-| stopAllSpotlight |  ✔️ | ✔️ |  |
-| getSpotlightedParticipants |  ✔️ | ✔️ | ✔️ |
-
 Spotlight is an extended feature of the core `Call` API. You first need to import calling Features from the Calling SDK:
 
 ```js
@@ -46,7 +26,7 @@ spotLightFeature.startSpotlight();
 ```
 
 ### Spotlight specific participants
-Any participant in the call or meeting can be pinned. Only Microsoft 365 users who have an organizer, co-organizer or presenter role can start spotlight for other participants. This action is idempotent, trying to start spotlight on a pinned participant does nothing
+Any participant in the call or meeting can be pinned. Only Microsoft 365 users who have an organizer, co-organizer, or presenter role can start spotlight for other participants. This action is idempotent, trying to start spotlight on a pinned participant does nothing
 ```js
 // Specify list of participants to be spotlighted
 CommunicationUserIdentifier acsUser = new CommunicationUserIdentifier(<USER_ID>);
@@ -63,7 +43,7 @@ spotLightFeature.stopSpotlight();
 
 
 ### Remove spotlight from participants
-Any pinned participant in the call or meeting can be unpinned. Only Microsoft 365 users who have an organizer, co-organizer or presenter role can unpin other participants. This action is idempotent, trying to stop spotlight on an unpinned participant does nothing 
+Any pinned participant in the call or meeting can be unpinned. Only Microsoft 365 users who have an organizer, co-organizer, or presenter role can unpin other participants. This action is idempotent, trying to stop spotlight on an unpinned participant does nothing 
 ```js
 // Specify list of participants to be spotlighted
 CommunicationUserIdentifier acsUser = new CommunicationUserIdentifier(<USER_ID>);
@@ -72,7 +52,7 @@ spotLightFeature.stopSpotlight([acsUser, teamsUser]);
 ```
 
 ### Remove all spotlights
-All pinned participants can be unpinned using this API. Only MicrosoftTeamsUserIdentifier users who have an organizer, co-organizer or presenter role can unpin all participants.
+All pinned participants can be unpinned using this API. Only Microsoft 365 users who have an organizer, co-organizer, or presenter role can unpin all participants.
 ```js
 spotLightFeature.stopAllSpotLight();
 ```
@@ -108,4 +88,11 @@ let spotlightedParticipants = spotLightFeature.getSpotlightedParticipants();
 The following API can be used to get the maximum number of participants that can be spotlighted using the Calling SDK
 ```js
 spotLightFeature.maxParticipantsToSpotlight;
-```
+```
+
+## Troubleshooting
+|code| Subcode | Result Category | Reason | Resolution |
+|----------------------------------------------|--------|--------|---------|----------|
+|400	| 45900 | ExpectedError  | All provided participant IDs are already spotlighted  | Only participants who aren't currently spotlighted can be spotlighted |
+|400 | 45902	| ExpectedError | The maximum number of participants that can be spotlighted has been reached | Only seven participants can be in the spotlight state at any given time |
+|403 | 45903	| ExpectedError | Only participants with the roles of organizer, co-organizer, or presenter can initiate a spotlight | Ensure the participant calling the `startSpotlight` API has assigned role of organizer, co-organizer or presenter |

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

@@ -13,7 +13,8 @@ zone_pivot_groups: acs-plat-web-ios-android-windows
 ---
 
 # Spotlight states
-In this article, you learn how to implement Microsoft Teams spotlight capability with Azure Communication Services Calling SDKs. This capability allows users in the call or meeting to pin and unpin videos for everyone.
+In this article, you learn how to implement Microsoft Teams spotlight capability with Azure Communication Services Calling SDKs. This capability allows users in the call or meeting to pin and unpin videos for everyone. The maximum limit of pinned videos is seven.
+
 Since the video stream resolution of a participant is increased when spotlighted, it should be noted that the settings done on [Video Constraints](../../concepts/voice-video-calling/video-constraints.md) also apply to spotlight.
 
 ## Prerequisites
@@ -24,6 +25,36 @@ Since the video stream resolution of a participant is increased when spotlighted
 - 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 for Spotlight in Azure Communication Services.
+
+### Identities & call types
+The following table shows support for call and identity 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	                        | ✔️	          |    ✔️  |          |        ✔️    |                        |        ✔️                  |
+
+### Operations
+The following table shows support for individual APIs in Calling SDK to individual identity types. 
+
+|Operations                   | Communication Services user | Microsoft 365 user |
+|-----------------------------|------------------------------|-------------------|
+| startSpotlight | ✔️ [1] | ✔️ [1] |
+| stopSpotlight | ✔️ | ✔️ |
+| stopAllSpotlight |  ✔️ [1] | ✔️ [1] | 
+| getSpotlightedParticipants |  ✔️ | ✔️ | 
+
+[1] In Teams meeting scenarios, these APIs are only available to users with role organizer, co-organizer, or presenter.
+
+### SDKs
+The following table shows support for Spotlight feature in individual Azure Communication Services SDKs.
+
+|  Platforms     | Web | Web UI | iOS | iOS UI | Android | Android UI | Windows |
+|---------------|-----|--------|--------|--------|----------|--------|---------|
+|Is Supported | ✔️  |  ✔️      |  ✔️      |        |  ✔️        |        |  ✔️       |
+
 ::: zone pivot="platform-web"
 [!INCLUDE [Spotlight Client-side JavaScript](./includes/spotlight/spotlight-web.md)]
 ::: zone-end