Skip to content

Commit 8662e5d

Browse files
committed
Added H2 headings
Added H2 headings to include files and merged the "operations" tables in the main article.
1 parent 72123ea commit 8662e5d

File tree

5 files changed

+33
-37
lines changed

5 files changed

+33
-37
lines changed

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

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,9 @@ ms.author: cnwankwo
88

99
[!INCLUDE [Install SDK](../install-sdk/install-sdk-android.md)]
1010

11-
Spotlight is an extended feature of the core Call API. You first need to import calling features from the Calling SDK.
11+
## Implement spotlight
12+
13+
Spotlight is an extended feature of the core `Call` API. You first need to import calling features from the Calling SDK.
1214

1315
```java
1416
import com.azure.android.communication.calling.SpotlightFeature;
@@ -20,6 +22,7 @@ Then you can get the feature API object from the call instance.
2022
SpotlightCallFeature spotlightCallFeature;
2123
spotlightCallFeature = call.feature(Features.SPOTLIGHT);
2224
```
25+
2326
### Start spotlight for participants
2427

2528
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
@@ -65,6 +68,7 @@ CommunicationUserIdentifier acsUser = new CommunicationUserIdentifier(<USER_ID>)
6568
MicrosoftTeamsUserIdentifier teamsUser = new MicrosoftTeamsUserIdentifier(<USER_ID>);
6669
spotlightCallFeature.StopSpotlight(acsUser, teamsUser);
6770
```
71+
6872
### Remove all spotlights
6973

7074
All pinned participants can be unpinned using this operation. Only `MicrosoftTeamsUserIdentifier` users who have an organizer, co-organizer, or presenter role can unpin all participants.

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

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,9 @@ ms.author: cnwankwo
77
---
88
[!INCLUDE [Install SDK](../install-sdk/install-sdk-ios.md)]
99

10-
Spotlight is an extended feature of the core Call API. You first need to import calling features from the Calling SDK.
10+
## Implement spotlight
11+
12+
Spotlight is an extended feature of the core `Call` API. You first need to import calling features from the Calling SDK.
1113

1214
```swift
1315
import AzureCommunicationCalling

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

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,9 @@ ms.author: cnwankwo
88

99
[!INCLUDE [Install SDK](../install-sdk/install-sdk-web.md)]
1010

11-
Spotlight is an extended feature of the core Call API. You first need to import calling features from the Calling SDK.
11+
## Implement spotlight
12+
13+
Spotlight is an extended feature of the core `Call` API. You first need to import calling features from the Calling SDK.
1214

1315
```js
1416
import { Features} from "@azure/communication-calling";

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

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,9 @@ ms.author: cnwankwo
77
---
88
[!INCLUDE [Install SDK](../install-sdk/install-sdk-windows.md)]
99

10-
Spotlight is an extended feature of the core Call API. You first need to import calling features from the Calling SDK.
10+
## Implement spotlight
11+
12+
Spotlight is an extended feature of the core `Call` API. You first need to import calling features from the Calling SDK.
1113

1214
```csharp
1315
using Azure.Communication.Calling.WindowsClient;

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

Lines changed: 19 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -36,19 +36,28 @@ The following table shows support for call and identity types.
3636

3737
| Identities | Teams meeting | Room | 1:1 call | Group call | 1:1 Teams interop call | Group Teams interop call |
3838
| --- | --- | --- | --- | --- | --- | --- |
39-
|Communication Services user | ✔️ | ✔️ | | ✔️ | | ✔️ |
40-
|Microsoft 365 user | ✔️ | ✔️ | | ✔️ | | ✔️ |
39+
|Communication Services user | ✔️ | ✔️ | | ✔️ | | ✔️ |
40+
|Microsoft 365 user | ✔️ | ✔️ | | ✔️ | | ✔️ |
4141

4242
## Operations
4343

44-
The following table shows support for individual operations in Calling SDK to individual identity types.
44+
Azure Communication Services or Microsoft 365 users can call spotlight operations based on role type and conversation type.
45+
46+
The following table shows support for individual operations in Calling SDK to individual identity types.
47+
48+
**In one-to-one calls, group calls, and meeting scenarios the following operations are supported for both Communication Services and Microsoft 365 users**
4549

46-
| Operations | Communication Services user | Microsoft 365 user |
50+
| Operations | Communication Services user | Microsoft 365 user |
4751
| --- | --- | --- |
48-
| startSpotlight | ✔️ [1] | ✔️ [1] |
49-
| stopSpotlight | ✔️ | ✔️ |
50-
| stopAllSpotlight | ✔️ [1] | ✔️ [1] |
51-
| getSpotlightedParticipants | ✔️ | ✔️ |
52+
| `startSpotlight` | ✔️ [1] | ✔️ [1] |
53+
| `stopSpotlight` | ✔️ | ✔️ |
54+
| `stopAllSpotlight` | ✔️ [1] | ✔️ [1] |
55+
| `getSpotlightedParticipants` | ✔️ | ✔️ |
56+
| `StartSpotlightAsync` | ✔️ [1] | ✔️ [1] |
57+
| `StopSpotlightAsync` | ✔️ [1] | ✔️ [1] |
58+
| `StopAllSpotlightAsync` | ✔️ [1] | ✔️ [1] |
59+
| `SpotlightedParticipants` | ✔️ [1] | ✔️ [1] |
60+
| `MaxSupported` | ✔️ [1] | ✔️ [1] |
5261

5362
[1] In Teams meeting scenarios, these operations are only available to users with role organizer, co-organizer, or presenter.
5463

@@ -58,31 +67,7 @@ The following table shows support for spotlight feature in individual Azure Comm
5867

5968
| Platforms | Web | Web UI | iOS | iOS UI | Android | Android UI | Windows |
6069
| --- | --- | --- | --- | --- | --- | --- | --- |
61-
|Is Supported | ✔️ | ✔️ | ✔️ | | ✔️ | | ✔️ |
62-
63-
## Spotlight features
64-
65-
Azure Communication Services or Microsoft 365 users can call spotlight operations based on role type and conversation type.
66-
67-
**In a one to one call or group call scenario, the following operations are supported for both Communication Services and Microsoft 365 users**
68-
69-
| Operations | Organizer | Presenter | Attendee |
70-
| --- | --- | --- | --- |
71-
| `StartSpotlightAsync` | ✔️ | ✔️ | ✔️ |
72-
| `StopSpotlightAsync` | ✔️ | ✔️ | ✔️ |
73-
| `StopAllSpotlightAsync` | ✔️ | ✔️ | ✔️ |
74-
| `SpotlightedParticipants` | ✔️ | ✔️ | ✔️ |
75-
| `MaxSupported` | ✔️ | ✔️ | ✔️ |
76-
77-
**For meeting scenario the following operations are supported for both Communication Services and Microsoft 365 users**
78-
79-
| Operations | Organizer | Presenter | Attendee |
80-
| --- | --- | --- | --- |
81-
| `StartSpotlightAsync` | ✔️ | ✔️ | |
82-
| `StopSpotlightAsync` | ✔️ | ✔️ | ✔️ |
83-
| `StopAllSpotlightAsync` | ✔️ | ✔️ | |
84-
| `SpotlightedParticipants` | ✔️ | ✔️ | ✔️ |
85-
| `MaxSupported` | ✔️ | ✔️ | ✔️ |
70+
| Is Supported | ✔️ | ✔️ | ✔️ | | ✔️ | | ✔️ |
8671

8772
::: zone pivot="platform-web"
8873
[!INCLUDE [Spotlight Client-side JavaScript](./includes/spotlight/spotlight-web.md)]
@@ -109,6 +94,7 @@ Azure Communication Services or Microsoft 365 users can call spotlight operation
10994
| 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. |
11095

11196
## Next steps
97+
11298
- [Learn how to manage calls](./manage-calls.md)
11399
- [Learn how to manage video](./manage-video.md)
114100
- [Learn how to record calls](./record-calls.md)

0 commit comments

Comments
 (0)