|
2 | 2 | title: Spotlight states
|
3 | 3 | titleSuffix: An Azure Communication Services how-to guide
|
4 | 4 | description: Use Azure Communication Services SDKs to send spotlight state.
|
5 |
| -author: cnwankwo |
6 |
| -ms.author: cnwankwo |
| 5 | +author: sloanster |
| 6 | +ms.author: micahvivion |
7 | 7 | ms.service: azure-communication-services
|
8 | 8 | ms.subservice: teams-interop
|
9 | 9 | ms.topic: how-to
|
10 |
| -ms.date: 03/01/2023 |
| 10 | +ms.date: 10/15/2024 |
11 | 11 | ms.custom: template-how-to
|
12 | 12 | zone_pivot_groups: acs-plat-web-ios-android-windows
|
13 | 13 | ---
|
14 | 14 |
|
15 | 15 | # Spotlight states
|
16 | 16 |
|
17 |
| -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. |
18 |
| - |
19 |
| -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. |
| 17 | +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" - it's a feature that enables users to tag other users in the call and notify all the participants about it. |
20 | 18 |
|
21 | 19 | ## Overview
|
22 | 20 |
|
23 |
| -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. |
| 21 | +Spotlight is a signaling feature rather than a media capability, application must decide how to handle spotligted participant, usually it means it will highligt spotligted user, put them in the center of UI layout, make their video renderer bigger, while keeping other participants and their video's smaller. |
| 22 | +The maximum limit of spotlited participants in a call is seven, meaning in a single call a total number of distinct users that are spotlighted is 7. |
| 23 | + |
| 24 | +Spotlighting a participant is possible in both ACS calls and in Teams meetings. In Teams meetings The organizer, co-organizer, or presenter can choose up to seven user's (including themselfs) to highlight for everyone else. |
| 25 | +In Teams meeting scenario - remind participants that they can't spotlight a video if their view is set to Large gallery or Together mode. |
24 | 26 |
|
25 |
| -The two different ways to spotlight are your own video and someone else's video (up to seven people). |
| 27 | +To enable higher resolution of the video for spotligted user, an application must ensure that a video (renderer) of a spotligted user is bigger than the video (renderer's) of all other users. |
| 28 | +Only by doing that, application can inform ACS SDK to request and subscribe to higher resolution stream, ACS SDK will try to request resolution that is close to the size of the renderer itself, assuming hardware and network capabilities of local endpoint allow for it, if they are not optimal, ACS SDK will degrade resolution to best possible to enable smooth video playback. |
26 | 29 |
|
27 |
| -When a user spotlights or pins someone in the meeting, this increases the height or width of the participant grid depending on the orientation. |
| 30 | +Video stream resolution of a participant can be also controlled via [Video Constraints](../../concepts/voice-video-calling/video-constraints.md), and it will override default behavior of ACS SDK that is mentioned above. |
28 | 31 |
|
29 |
| -Remind participants that they can't spotlight a video if their view is set to Large gallery or Together mode. |
30 | 32 |
|
31 | 33 | ## Prerequisites
|
32 | 34 |
|
|
0 commit comments