Skip to content

Commit ef06618

Browse files
committed
Standardize and update reactions
Added Support section to match other teams interop articles, ran Acrolinx.
1 parent 72dcfae commit ef06618

File tree

2 files changed

+59
-22
lines changed

2 files changed

+59
-22
lines changed

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

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,20 +5,23 @@ ms.topic: include
55
ms.date: 10/20/2023
66
ms.author: jacadd
77
---
8+
89
[!INCLUDE [Install SDK](../install-sdk/install-sdk-web.md)]
910

10-
## Send or receive a reaction from other participants
11+
## Implement reactions for meeting participants
12+
13+
In Azure Communication Services participants can send and receive reactions during a group call:
1114

12-
Within Azure Communication Services you can send and receive reactions when on a group call:
1315
- Like :::image type="icon" source="media/reaction-like.png":::
1416
- Love :::image type="icon" source="media/reaction-love.png":::
1517
- Applause :::image type="icon" source="media/reaction-applause.png":::
1618
- Laugh :::image type="icon" source="media/reaction-laugh.png":::
1719
- Surprise :::image type="icon" source="media/reaction-surprise.png":::
1820

19-
To send a reaction, use the `sendReaction(reactionMessage)` API. To receive a reaction, the message will be built with Type `ReactionMessage` that uses `Reaction` enums as an attribute.
21+
To send a reaction, use the `sendReaction(reactionMessage)` API. To receive a reaction, the message builds with type `ReactionMessage` using `Reaction` enums as an attribute.
22+
23+
You need to subscribe to events that provide the subscriber event data:
2024

21-
You need to subscribe for events that provide the subscriber event data:
2225
```javascript
2326
export interface ReactionEventPayload {
2427
/**
@@ -32,9 +35,10 @@ export interface ReactionEventPayload {
3235
}
3336
```
3437

35-
You can determine which reaction is coming from which participant with `identifier` attribute and gets the reaction type from `ReactionMessage`.
38+
You can determine which reaction is coming from which participant using the `identifier` attribute and getting the reaction type from `ReactionMessage`.
39+
40+
### Sample showing how to send a reaction in a meeting
3641

37-
### Sample on how to send a reaction in a meeting
3842
```javascript
3943
const reaction = call.feature(SDK.Features.Reaction);
4044
const reactionMessage: SDK.ReactionMessage = {
@@ -43,7 +47,8 @@ const reactionMessage: SDK.ReactionMessage = {
4347
await reaction.sendReaction(reactionMessage);
4448
```
4549

46-
### Sample on how to receive a reaction in a meeting
50+
### Sample showing how to receive a reaction in a meeting
51+
4752
```javascript
4853
const reaction = call.feature(SDK.Features.Reaction);
4954
reaction.on('reaction', event => {
@@ -56,7 +61,8 @@ reaction.on('reaction', event => {
5661
}
5762
```
5863
59-
### Key things to note about using Reactions:
60-
- For Microsoft Teams interoperability scenarios, the functionality of the feature depends on the meeting policy for the reaction capability.
64+
### Key points when using reactions
65+
66+
- Reactions are supported for Microsoft Teams interoperability scenarios. Support is based on [Teams policy](/microsoftteams/manage-reactions-meetings).
6167
- Reactions are supported in the Web Calling SDK.
62-
- Reactions are not currently supported in the Native SDKs.
68+
- Reactions aren't currently supported in the Native SDKs.

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

Lines changed: 43 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,29 +13,60 @@ ms.custom: template-how-to
1313
---
1414

1515
# Reactions
16-
In this article, you learn how to implement the reactions capability with Azure Communication Services Calling SDKs. This capability allows users in a group call or meeting to send and receive reactions with participants in Azure Communication Services and Microsoft Teams. Reactions for users in Microsoft Teams are controlled by the configuration and policy settings in Teams. Additional information is available in [Manage reactions in Teams meetings and webinars](/microsoftteams/manage-reactions-meetings) and [Meeting options in Microsoft Teams](https://support.microsoft.com/office/meeting-options-in-microsoft-teams-53261366-dbd5-45f9-aae9-a70e6354f88e)
16+
17+
This article describes how to implement reactions for Azure Communication Services Calling SDKs. This capability enables participants in a group call or meeting to send and receive reactions with participants in Azure Communication Services and Microsoft Teams.
18+
19+
The configuration and policy settings in Microsoft Teams control reactions for users in Teams meetings. For more information, see [Manage reactions in Teams meetings and webinars](/microsoftteams/manage-reactions-meetings) and [Meeting options in Microsoft Teams](https://support.microsoft.com/office/meeting-options-in-microsoft-teams-53261366-dbd5-45f9-aae9-a70e6354f88e).
1720

1821
## Prerequisites
1922

2023
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
2124
- A deployed Communication Services resource. [Create a Communication Services resource](../../quickstarts/create-communication-resource.md).
2225
- A user access token to enable the calling client. For more information, see [Create and manage access tokens](../../quickstarts/identity/access-tokens.md).
23-
- Optional: Complete the quickstart to [add voice calling to your application](../../quickstarts/voice-video-calling/getting-started-with-calling.md)
24-
25-
## Reaction in different call types
26-
Reactions are supported by Azure Communication SDK in these types of calls:
27-
- Room Call, allowed by default
28-
- Group Call, allowed by default
29-
- Teams meeting, based on [Teams policy](/microsoftteams/manage-reactions-meetings)
30-
31-
Reactions are not supported for 1:1 call.
26+
- Optional: Complete the quickstart to [add voice calling to your application](../../quickstarts/voice-video-calling/getting-started-with-calling.md).
3227

3328
## Limits on reactions
34-
Reactions are pulling by batches with same interval. Current batch limitation is 20k reactions with pulling time 3 seconds.
35-
If the number of reactions exceeds the limit - they will be sent in second batch.
29+
30+
The system pulls reactions by batches at regular intervals. Current batch limitation is 20,000 reactions pulled every 3 seconds.
31+
32+
If the number of reactions exceeds the limit, leftover reactions are sent in the next batch.
33+
34+
## Support
35+
36+
The following tables define support for reactions in Azure Communication Services.
37+
38+
Teams meeting support is based on [Teams policy](/microsoftteams/manage-reactions-meetings).
39+
40+
### Identities and call types
41+
42+
The following table shows support for reactions in different call and identity types.
43+
44+
| Identities | Teams interop meeting | Room | 1:1 call | Group call | Teams interop Group Call |
45+
| --- | --- | --- | --- | --- | --- |
46+
| Communication Services user | ✔️ | ✔️ | | ✔️ | ✔️ |
47+
| Microsoft 365 user | ✔️ | | | ✔️ | ✔️ |
48+
49+
### Operations
50+
51+
The following table shows support for reactions in Calling SDK to individual identity types.
52+
53+
| Operations | Communication Services user | Microsoft 365 user |
54+
| --- | --- | --- |
55+
| Send specific reactions (like, love, laugh, applause, surprised) | ✔️ | ✔️ |
56+
| Receive specific reactions (like, love, laugh, applause, surprised) | ✔️ | ✔️ |
57+
58+
### SDKs
59+
60+
The following table shows support for Together Mode feature in individual Azure Communication Services SDKs.
61+
62+
| Platforms | Web | Web UI | iOS | iOS UI | Android | Android UI | Windows |
63+
| --- | --- | --- | --- | --- | --- | --- | --- |
64+
| Is Supported | ✔️ | ✔️ | | | | | |
65+
3666

3767
[!INCLUDE [Reactions JavaScript](./includes/reactions/reactions-web.md)]
3868

3969
## Next steps
70+
4071
- [Learn how to manage calls](./manage-calls.md)
4172
- [Learn how to manage video](./manage-video.md)

0 commit comments

Comments
 (0)