Skip to content

Commit 718874f

Browse files
authored
updated with suggested changes
1 parent 8484858 commit 718874f

File tree

2 files changed

+10
-10
lines changed

2 files changed

+10
-10
lines changed

articles/communication-services/concepts/voice-video-calling/video-constraints.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,17 +7,17 @@ ms.author: micahvivion
77
manager: nmurav
88

99
services: azure-communication-services
10-
ms.date: 2/20/2023
10+
ms.date: 2/15/2024
1111
ms.topic: conceptual
1212
ms.service: azure-communication-services
1313
ms.subservice: calling
1414
---
1515

1616
# Video constraints
1717

18-
The Video constraints API is a powerful tool that enables developers to control the video quality from within their video calls. With this API, developers can set maximum video resolutions, frame rate, and bitrate used so that the call is optimized for the user's device and network conditions. The ACS video engine is optimized to allow the video quality to change dynamically based on devices ability and network quality. But there might be certain scenarios where you would want to have tighter control of the video quality that end users experience. For instance, there may be situations where the highest video quality is not a priority, or you may want to limit the video bandwidth usage in the application. To support those use cases, you can use the Video Constraints API to have tighter control over video quality.
18+
The Video constraints API is a powerful tool that enables developers to control the video quality from within their video calls. With this API, developers can set maximum video resolutions, frame rate, and bitrate used so that the call is optimized for the user's device and network conditions. The ACS video engine is optimized to allow the video quality to change dynamically based on devices ability and network quality. But there might be certain scenarios where you would want to have tighter control of the video quality that end users experience. For instance, there may be situations where the highest video quality isn't a priority, or you may want to limit the video bandwidth usage in the application. To support those use cases, you can use the Video Constraints API to have tighter control over video quality.
1919

20-
Another benefit of the Video Constraints API is that it enables developers to optimize the video call for different devices. For example, if a user is using an older device with limited processing power, developers can set constraints on the video resolution to ensure that the video call runs smoothly on that device
20+
Another benefit of the Video Constraints API is that it enables developers to optimize the video call for different devices. For example, if a user is using an older device with limited processing power, developers can set constraints on the video resolution to ensure that the video call runs smoothly on that device.
2121

2222
## Supported constraints
2323

articles/communication-services/quickstarts/voice-video-calling/includes/video-constraints/video-constraints-javascript.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,16 @@
22
ms.author: enricohuang
33
title: Quickstart - Set video constraints in your web calling app
44
titleSuffix: An Azure Communication Services document
5-
description: In this quickstart, you'll learn how to set video constraints in your existing web calling app using Azure Communication Services.
5+
description: In this quickstart, you learn how to set video constraints in your existing web calling app using Azure Communication Services.
66
author: sloanster
77
services: azure-communication-services
8-
ms.date: 07/13/2023
8+
ms.date: 02/15/2024
99
ms.topic: include
1010
ms.service: azure-communication-services
1111
ms.subservice: calling
1212
---
1313

14-
You can set video constraints in your calls to control the video quality based on resolution or frameRate or bitrate in your video calls. In this quickstart guide, we'll illustrate how to set video constraints at the start of a call and how to use our `setConstraints` method on the call object to set video constraints dynamically during the call.
14+
You can set video constraints in your calls to control the video quality based on resolution or frameRate or bitrate in your video calls. In this quickstart guide, we illustrate how to set video constraints at the start of a call and how to use our `setConstraints` method on the call object to set video constraints dynamically during the call.
1515

1616

1717
[!INCLUDE [Public Preview](../../../../includes/public-preview-include-document.md)]
@@ -20,8 +20,8 @@ You can set video constraints in your calls to control the video quality based o
2020
Azure Communication Services Web Calling SDK supports setting the maximum video resolution, framerate, or bitrate that a client sends. The sender video constraints are supported on Desktop browsers (Chrome, Edge, Firefox) and when using iOS Safari mobile browser or Android Chrome mobile browser.
2121

2222
### Setting video constraints at the start of a call - outgoing (send) video
23-
The video constraints setting is implemented on the `Call` interface. To use the Video Constraints, you can specify the constraints from within `CallOptions` when you make a call, accept a call, or join a call. You will also have to specify `localVideoStreams` in `videoOptions`. <br/>
24-
Do note that constraints don't work if you join a call with audio only option and turn on the camera later. In this case, you can set video constraints dynamically using the `setConstraints` method on the `Call` interface (guide below).
23+
The video constraints setting is implemented on the `Call` interface. To use the Video Constraints, you can specify the constraints from within `CallOptions` when you make a call, accept a call, or join a call. You must specify `localVideoStreams` in `videoOptions`. <br/>
24+
Do note that constraints don't work if you join a call with audio only option and turn on the camera later. In this case, you can set video constraints dynamically using the `setConstraints` method on the `Call` interface.
2525

2626
```javascript
2727
const callOptions = {
@@ -87,7 +87,7 @@ export declare type MediaConstraintRange = {
8787
};
8888
```
8989

90-
When setting video constraints, the SDK will choose the nearest value that falls within the constraint set (to prevent the values for resolution, frameRate and bitrate to not exceed the maximum constraint values set). Also, when the resolution constraint value is too small, the SDK will choose the smallest available resolution. In this case, the height of chosen resolution can be larger than the constraint value.
90+
When setting video constraints, the SDK chooses the nearest value that falls within the constraint set to prevent the values for resolution, frameRate and bitrate to not exceed the maximum constraint values set. Also, when the resolution constraint value is too small, the SDK chooses the smallest available resolution. In this case, the height of chosen resolution can be larger than the constraint value.
9191

9292
> [!NOTE]
9393
> For all `bitrate`, `frameHeight` and `frameRate`, the constraint value is a `max` constraint, which means the actual value in the call can be the specified value or smaller.
@@ -145,7 +145,7 @@ await currentCall.setConstraints({
145145
<br/>
146146

147147
## Receive video constraints
148-
To control resolution on the receiver side usingAzure Communication Services Web Calling SDK you can adjust size of the renderer of that video. The calling SDK will automatically adjust received resolution based on the dimensions of the renderer. The SDK will not request more stream (width annd height) than it can fit into the renderer video window.
148+
To control resolution on the receiver side using Azure Communication Services Web Calling SDK, you can adjust size of the renderer of that video. The calling SDK automatically adjust received resolution based on the dimensions of the renderer. The SDK will not request an incoming video stream (width and height) than it can fit into the renderer video window.
149149

150150

151151

0 commit comments

Comments
 (0)