Skip to content

Commit 7589f1e

Browse files
authored
Update spotlight.md
1 parent 8a4256e commit 7589f1e

File tree

1 file changed

+12
-10
lines changed
  • articles/communication-services/how-tos/calling-sdk

1 file changed

+12
-10
lines changed

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

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,31 +2,33 @@
22
title: Spotlight states
33
titleSuffix: An Azure Communication Services how-to guide
44
description: Use Azure Communication Services SDKs to send spotlight state.
5-
author: cnwankwo
6-
ms.author: cnwankwo
5+
author: sloanster
6+
ms.author: micahvivion
77
ms.service: azure-communication-services
88
ms.subservice: teams-interop
99
ms.topic: how-to
10-
ms.date: 03/01/2023
10+
ms.date: 10/15/2024
1111
ms.custom: template-how-to
1212
zone_pivot_groups: acs-plat-web-ios-android-windows
1313
---
1414

1515
# Spotlight states
1616

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.
2018

2119
## Overview
2220

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.
2426

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.
2629

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.
2831

29-
Remind participants that they can't spotlight a video if their view is set to Large gallery or Together mode.
3032

3133
## Prerequisites
3234

0 commit comments

Comments
 (0)