Merge pull request #288451 from sloanster/patch-25

Update spotlight.md

Author: prmerger-automator[bot]

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

@@ -2,31 +2,28 @@
 title: Spotlight states
 titleSuffix: An Azure Communication Services how-to guide
 description: Use Azure Communication Services SDKs to send spotlight state.
-author: cnwankwo
-ms.author: cnwankwo
+author: sloanster
+ms.author: micahvivion
 ms.service: azure-communication-services
 ms.subservice: teams-interop
 ms.topic: how-to 
-ms.date: 03/01/2023
+ms.date: 10/15/2024
 ms.custom: template-how-to
 zone_pivot_groups: acs-plat-web-ios-android-windows
 ---
 
 # Spotlight states
 
-This article describes how to implement Microsoft Teams spotlight capability with Azure Communication Services Calling SDKs. This capability enables 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.
+This article describes how to implement spotlight capability with Azure Communication Services Calling SDKs. This capability enables users in the call or meeting to signal to other participants that selected user should be **in the spotlight**. This feature enables users to tag other users in the call and notify all the participants that someone is spotlighted and other clients need to change the User Interface layout for that user.
 
 ## Overview
 
-Spotlighting a video is like pinning it for everyone in the meeting. The organizer, co-organizer, or presenter can choose up to seven people's video feeds (including their own) to highlight for everyone else.
+Spotlight serves as a signaling feature instead of a media capability. Once someone is spotlighted applications can determine how to manage or adjust the spotlighted participant User Interface, typically by highlighting them, placing them at the center of the UI layout, and enlarging their video renderer size while keeping other participants' videos smaller. The maximum limit of spotlighted participants in a call is seven, meaning in a single call a total number of distinct users that are spotlighted is 7.
 
-The two different ways to spotlight are your own video and someone else's video (up to seven people).
+Spotlighting a participant is possible in both ACS calls and in Teams meetings. In Teams meetings the organizer, coorganizer, or presenter can choose up to seven user's (including themselves) to be in the spotlight. Do remember in a Teams meeting scenario, when a call is set to Large gallery or Together mode participants can't change the UI layout.
 
-When a user spotlights or pins someone in the meeting, this increases the height or width of the participant grid depending on the orientation.
+To enable higher resolution for a spotlighted user's video, the application must ensure that their video renderer is larger than those of other users displayed on the screen. This allows the ACS SDK to request and subscribe to a higher resolution stream, which matches the renderer's size, provided hardware and network conditions permit. If not optimal, the SDK adjusts the resolution for smooth playback. Resolution can also be controlled using via [Video Constraints](../../concepts/voice-video-calling/video-constraints.md), overriding the default ACS SDK behavior.
 
-Remind participants that they can't spotlight a video if their view is set to Large gallery or Together mode.
 
 ## Prerequisites
 
@@ -101,7 +98,7 @@ The following table shows support for spotlight feature in individual Azure Comm
 | --- | --- | --- | --- | --- |
 | 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 are already spotlighted. | 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` operation has the role of organizer, co-organizer, or presenter. |
+| 403 | 45903	| ExpectedError | Only participants with the roles of organizer, coorganizer, or presenter can initiate a spotlight. | Ensure the participant calling the `startSpotlight` operation has the role of organizer, coorganizer, or presenter. |
 
 ## Next steps