Skip to content

Commit dc07620

Browse files
authored
Merge pull request #267186 from sloanster/master
Creating more structure to list known issues.
2 parents fa2682e + 7e9a5d0 commit dc07620

File tree

10 files changed

+438
-12
lines changed

10 files changed

+438
-12
lines changed

articles/communication-services/concepts/known-issues.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
---
22
title: Azure Communication Services - known issues
33
description: Learn more about Azure Communication Services
4-
author: tophpalmer
4+
author: sloanster
55
manager: chpalm
66
services: azure-communication-services
77

8-
ms.author: chpalm
9-
ms.date: 06/30/2021
8+
ms.author: micahvivion
9+
ms.date: 02/24/2024
1010
ms.topic: conceptual
1111
ms.service: azure-communication-services
1212
ms.custom: devx-track-js
1313
---
1414

1515
# Known issues in the SDKs and APIs
1616

17-
This article provides information about limitations and known issues related to the Azure Communication Services Calling SDKs and Communication Services Call Automation APIs.
17+
These articles provide information about limitations and known issues related to the Azure Communication Services Calling SDKs and Communication Services Call Automation APIs.
1818

1919
> [!IMPORTANT]
2020
> There are multiple factors that can affect the quality of your calling experience. To learn more about Communication Services network configuration and testing best practices, see [Network recommendations](./voice-video-calling/network-requirements.md).

articles/communication-services/concepts/voice-video-calling/calling-sdk-features.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
title: Azure Communication Services Calling SDK overview
33
titleSuffix: An Azure Communication Services concept document
44
description: Provides an overview of the Calling SDK capabilities limitations features for video and audio.
5-
author: tophpalmer
5+
author: sloanster
66
manager: chpalm
77
services: azure-communication-services
88

9-
ms.author: chpalm
9+
ms.author: micahvivion
1010
ms.date: 02/24/2024
1111
ms.topic: conceptual
1212
ms.service: azure-communication-services
@@ -156,7 +156,7 @@ For example, this iframe allows both camera and microphone access:
156156

157157
**The maximum call duration is 30 hours**, participants that reach the maximum call duration lifetime of 30 hours will be disconnected from the call.
158158

159-
## Limits to the number of simultaneous video streams
159+
## Supported number of incoming video streams
160160

161161
The Azure Communication Services Calling SDK supports the following streaming configurations:
162162

@@ -169,14 +169,20 @@ The Azure Communication Services Calling SDK supports the following streaming co
169169
While the Calling SDK doesn't enforce these limits, your users might experience performance degradation if they're exceeded. Use the API of [Optimal Video Count](../../how-tos/calling-sdk/manage-video.md?pivots=platform-web#remote-video-quality) to determine how many current incoming video streams your web environment can support.
170170

171171
## Supported video resolutions
172-
The Azure Communicaton Services Calling SDK support up to the following video resolutions:
172+
The Azure Communication Services Calling SDK support up to the following video resolutions:
173173

174174
| Maximum video resolution | WebJS | iOS | Android | Windows |
175175
| ------------- | ----- | ----- | ------- | ------- |
176176
| **Receiving video** | 1080P | 1080P | 1080P | 1080P |
177177
| **Sending video** | 720P | 720P | 720P | 1080P |
178178

179-
The resolution can vary depending on the number of participants on a call, the amount of bandwidth available to the client, and other overall call parameters.
179+
The resolution can vary depending on the number of participants on a call, the amount of bandwidth available to the client, and other overall call parameters. Read
180+
181+
## Number of participants on a call support
182+
- Up to 350 users can join a group call, Room or Teams + ACS call. The maximum number of users that can join through WebJS calling SDK or Teams web client is capped at 100 participants, the remaining calling end point will need to join using Android, iOS, or Windows calling SDK or related Teams desktop or mobile client apps.
183+
- Once the call size reaches 100+ participants in a call, only the top 4 most dominant speakers that have their video camera turned can be seen.
184+
- When the number of people on the call is 100+, the viewable number of incoming video renders automatically decreases from 3x3 (9 incoming videos) down to 2x2 (4 incoming videos).
185+
- When the number of users goes below 100, the number of supported incoming videos goes back up to 3x3 (9 incoming videos).
180186

181187
## Calling SDK timeouts
182188
The following timeouts apply to the Communication Services Calling SDKs:
Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
---
2+
title: Azure Communication Services - known issues - all browsers
3+
description: Learn more about known issues on Azure Communication Service calling when using all browsers
4+
author: sloanster
5+
services: azure-communication-services
6+
7+
ms.author: micahvivion
8+
ms.date: 02/23/2024
9+
ms.topic: include
10+
ms.service: azure-communication-services
11+
ms.subservice: calling
12+
ms.custom: template-how-to
13+
---
14+
15+
## All Desktop browsers
16+
17+
18+
### It isn't possible to render multiple previews from multiple devices on web
19+
**Browser version:** All.<br>
20+
**Azure Communication Service calling SDK version:** All.<br>
21+
**Description:** It isn't possible to render multiple previews from multiple devices on web. This issue is a known limitation.<br>
22+
**Known issue reference:** For more information, see [Calling SDK overview](../../../voice-video-calling/calling-sdk-features.md).<br>
23+
24+
25+
### Repeatedly switching video devices might cause video streaming to stop temporarily
26+
**Browser version:** All.<br>
27+
**Azure Communication Service calling SDK version:** All.<br>
28+
**Description:** Switching between video devices might cause your video stream to pause while the stream is acquired from the selected device. Switching between devices frequently can cause performance degradation.<br>
29+
**Recommended workaround:** Developers should ensure to stop the stream from one device before starting another to mitigate performance degradation when switching between video devices.<br>
30+
31+
32+
### Video signal problem when the call is in connecting state
33+
**Browser version:** All. <br>
34+
**Azure Communication Service calling SDK version:** All.<br>
35+
**Description:** If a user turns video on and off quickly while the call is in the *Connecting* state, this action might lead to a problem with the stream acquired for the call. It's best for developers to build their apps in a way that doesn't require video to be turned on and off while the call is in the *Connecting* state. Degraded video performance might occur in the following scenarios:
36+
- If the user starts with audio, and then starts and stops video, while the call is in the *Connecting* state.
37+
- If the user starts with audio, and then starts and stops video, while the call is in the *Lobby* state.
38+
<br>
39+
40+
### Delay in rendering remote participant videos
41+
**Browser version:** All.<br>
42+
**Azure Communication Service calling SDK version:** All.<br>
43+
**Description:** During an ongoing group call, suppose that *User A* sends video, and then *User B* joins the call. Sometimes, User B doesn't see video from User A, or User A's video begins rendering after a long delay. A network environment configuration problem might cause this delay.<br>
44+
**Known issue reference:** For more information [Network recommendations](../../../voice-video-calling/network-requirements.md).<br>
45+
46+
### Excessive use of certain APIs like mute/unmute results in throttling on Azure Communication Services infrastructure
47+
**Browser version:** All.<br>
48+
**Azure Communication Service calling SDK version:** All.<br>
49+
**Description:** As a result of the mute/unmute API call, Azure Communication Services infrastructure informs other participants in the call about the state of audio of a local participant who invoked mute/unmute, so that participants in the call know who is muted/unmuted.
50+
51+
Excessive use of mute/unmute is blocked in Azure Communication Services infrastructure. Throttling happens if the participant (or application on behalf of participant) attempts to mute/unmute continuously, every second, more than 15 times in a 30-second rolling window.
52+
<br>
53+
54+
## All mobile browser
55+
56+
57+
### It isn't possible to render multiple previews from multiple devices on web
58+
**Browser version:** All.<br>
59+
**Azure Communication Service calling SDK version:** All.<br>
60+
**Description:** It isn't possible to render multiple previews from multiple devices on web. This issue is a known limitation.<br>
61+
**Known issue reference:** For more information, see [Calling SDK overview](../../../voice-video-calling/calling-sdk-features.md).<br>
62+
63+
### Repeatedly switching video devices might cause video streaming to stop temporarily
64+
**Browser version:** All.<br>
65+
**Azure Communication Service calling SDK version:** All.<br>
66+
**Description:** Switching between video devices might cause your video stream to pause while the stream is acquired from the selected device. Switching between devices frequently can cause performance degradation.<br>
67+
**Recommended workaround:** Developers should ensure to stop the stream from one device before starting another to mitigate performance degradation when switching between video devices.<br>
68+
69+
### Video signal problem when the call is in connecting state
70+
**Browser version:** All.<br>
71+
**Azure Communication Service calling SDK version:** All.<br>
72+
**Description:** If a user turns video on and off quickly while the call is in the *Connecting* state, this action might lead to a problem with the stream acquired for the call. It's best for developers to build their apps in a way that doesn't require video to be turned on and off while the call is in the *Connecting* state. Degraded video performance might occur in the following scenarios:
73+
- If the user starts with audio, and then starts and stops video, while the call is in the *Connecting* state.
74+
- If the user starts with audio, and then starts and stops video, while the call is in the *Lobby* state.
75+
76+
77+
### Delay in rendering remote participant videos
78+
**Browser version:** All.<br>
79+
**Azure Communication Service calling SDK version:** All.<br>
80+
**Description:** During an ongoing group call, suppose that *User A* sends video, and then *User B* joins the call. Sometimes, User B doesn't see video from User A, or User A's video begins rendering after a long delay. A network environment configuration problem might cause this delay.<br>
81+
**Known issue reference:** For more information [Network recommendations](../../../voice-video-calling/network-requirements.md). <br>
82+
83+
### Excessive use of certain APIs like mute/unmute results in throttling on Azure Communication Services infrastructure
84+
**Browser version:** All.<br>
85+
**Azure Communication Service calling SDK version:** All<br>
86+
**Description:** As a result of the mute/unmute API call, Azure Communication Services infrastructure informs other participants in the call about the state of audio of a local participant who invoked mute/unmute, so that participants in the call know who is muted/unmuted.<br>
87+
88+
Excessive use of mute/unmute is blocked in Azure Communication Services infrastructure. Throttling happens if the participant (or application on behalf of participant) attempts to mute/unmute continuously, every second, more than 15 times in a 30-second rolling window.
89+
90+
### Refreshing a page doesn't immediately remove the user from their call
91+
**Browser version:** All.<br>
92+
**Azure Communication Service calling SDK version:** All.<br>
93+
**Description:** If a user is in a call and decides to refresh the page, the Communication Services media service doesn't remove this user immediately from the call. It waits for the user to rejoin. The user is removed from the call after the media service times out.
94+
95+
If a user is in a call and decides to refresh the page, the Communication Services media service doesn't remove this user immediately from the call. It waits for the user to rejoin. The user is removed from the call after the media service times out.
96+
97+
It's best to build user experiences that don't require end users to refresh the page of your application while in a call. If a user refreshes the page, reuse the same Communication Services user ID after that user returns back to the application. By rejoining with the same user ID, the user is represented as the same, existing object in the `remoteParticipants` collection. From the perspective of other participants in the call, the user remains in the call during the time it takes to refresh the page, up to a minute or two.
98+
99+
If the user was sending video before refreshing, the `videoStreams` collection keeps the previous stream information until the service times out and removes it. In this scenario, the application might decide to observe any new streams added to the collection, and render one with the highest `id`.

0 commit comments

Comments
 (0)