Skip to content

Commit e881bdf

Browse files
committed
Reconcile titles with TOC (10)
1 parent 693d48d commit e881bdf

File tree

6 files changed

+90
-68
lines changed

6 files changed

+90
-68
lines changed

articles/communication-services/how-tos/calling-sdk/powerpoint-live.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,9 @@ ms.custom: template-how-to
1414

1515
# View PowerPoint Live presentations
1616

17-
This article describes how to enable meeting participants to view [PowerPoint Live presentations in Microsoft Teams](https://support.microsoft.com/en-us/office/present-from-powerpoint-live-in-microsoft-teams-28b20e74-7165-499c-9bd4-0ad975d448ad) using the Azure Communication Services Calling SDKs.
17+
This article describes how to enable meeting participants to view [PowerPoint Live presentations in Microsoft Teams](https://support.microsoft.com/office/present-from-powerpoint-live-in-microsoft-teams-28b20e74-7165-499c-9bd4-0ad975d448ad) using the Azure Communication Services Calling SDKs.
1818

19-
Attendees who use Azure Communication Services Calling SDKs to [join a Microsoft Teams meeting](./teams-interoperability.md) can view PowerPoint Live presentations and interact with [reactions](./reactions.md) and [raise hand](./raise-hand.md). The attendee view automatically maintains synchronization with the current slide of the Microsoft Teams presenter.
19+
Attendees who use Azure Communication Services Calling SDKs to [join a Microsoft Teams meeting](./teams-interoperability.md) can view PowerPoint Live presentations and interact with [reactions](./reactions.md) and [raise hand](./raise-hand.md). The attendee view automatically synchronizes with the current slide of the Microsoft Teams presenter.
2020

2121
## Prerequisites
2222

articles/communication-services/quickstarts/voice-video-calling/get-started-video-constraints.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,20 @@
11
---
2-
ms.author: micahvivion
3-
title: Quickstart - Set video constraints in your calling app
4-
titleSuffix: An Azure Communication Services quickstart
5-
description: In this quickstart, you learn how to set video constraints in your existing calling app using Azure Communication Services.
2+
3+
title: Set video constraints in a calling app
4+
titleSuffix: An Azure Communication Services article
5+
description: This article describes how to set video constraints in your existing calling app using Azure Communication Services.
66
author: sloanster
7+
ms.author: micahvivion
78
services: azure-communication-services
8-
ms.date: 02/18/2024
9+
ms.date: 06/26/2025
910
ms.topic: quickstart
1011
ms.service: azure-communication-services
1112
ms.subservice: calling
1213
zone_pivot_groups: acs-plat-web-ios-android-windows
1314
ms.custom: mode-other, devx-track-js
1415
---
1516

16-
# Quickstart: Set video constraints in your calling app
17+
# Set video constraints in a calling app
1718

1819
::: zone pivot="platform-windows"
1920
[!INCLUDE [Set video constraints with Windows](./includes/video-constraints/video-constraints-windows.md)]
@@ -30,9 +31,9 @@ ms.custom: mode-other, devx-track-js
3031
::: zone pivot="platform-web"
3132
[!INCLUDE [Set video constraints with JavaScript](./includes/video-constraints/video-constraints-javascript.md)]
3233
::: zone-end
33-
## Next steps
3434

35-
For more information, see the following articles:
35+
36+
## Next steps
3637

3738
- Learn about [Video Constraints concept document](../../concepts/voice-video-calling/video-constraints.md)
3839
- Learn more about [Calling SDK capabilities](./getting-started-with-calling.md)

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

Lines changed: 25 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
ms.author: chengyuanlai
3-
title: Quickstart - Set video constraints in your Android calling app
4-
titleSuffix: An Azure Communication Services document
5-
description: In this quickstart, you learn how to set video constraints in your existing Android calling app using Azure Communication Services.
3+
title: Set video constraints in an Android calling app
4+
titleSuffix: An Azure Communication Services article
5+
description: This article describes how to set video constraints in your existing Android calling app using Azure Communication Services.
66
author: sloanster
77
services: azure-communication-services
8-
ms.date: 07/10/2023
8+
ms.date: 06/26/2025
99
ms.topic: include
1010
ms.service: azure-communication-services
1111
ms.subservice: calling
@@ -14,25 +14,29 @@ ms.subservice: calling
1414
[!INCLUDE [Public Preview](../../../../includes/public-preview-include-document.md)]
1515

1616
## Overview
17-
The Video Constraints API enables developers to control the video quality from within their video calls. In this quickstart guide, we illustrate how to use the API to set the constraints.
17+
18+
The Video Constraints API enables developers to control the video quality from within their video calls. In this article, we illustrate how to use the API to set the constraints.
1819

1920
### Prerequisites
21+
2022
Refer to the [Voice Calling Quickstart](../../getting-started-with-calling.md?pivots=platform-android) to set up a sample app with voice calling.
2123

2224
### Classes
25+
2326
| Name | Description |
24-
| - | - |
27+
| --- | --- |
2528
| VideoConstraints | Used to hold both incoming video constraints and outgoing video constraints. |
26-
| OutgoingVideoConstraints | Used to specify constraints (`maxWidth | maxHeight | maxFrameRate`) for outgoing video streams. |
27-
| IncomingVideoConstraints | Used to specify constraints (`maxWidth | maxHeight`) for incoming video streams. |
29+
| OutgoingVideoConstraints | Used to specify constraints (`maxWidth \| maxHeight \| maxFrameRate`) for outgoing video streams. |
30+
| IncomingVideoConstraints | Used to specify constraints (`maxWidth \| maxHeight`) for incoming video streams. |
2831

2932
### Using video constraints
3033

3134
The following sections explain how the video constraints can be set for incoming and/or outgoing video streams at different times of a call.
3235

3336
#### Set video constraints before starting a call
3437

35-
For *incoming* video streams, an `IncomingVideoConstraints` needs to be added to the `IncomingVideoOptions`.
38+
For *incoming* video streams, you need to add an `IncomingVideoConstraints` to the `IncomingVideoOptions`.
39+
3640
```java
3741
IncomingVideoConstraints incomingVideoConstraints = new IncomingVideoConstraints();
3842
incomingVideoConstraints.setMaxWidth(/*value*/);
@@ -44,7 +48,8 @@ For *incoming* video streams, an `IncomingVideoConstraints` needs to be added to
4448
incomingVideoOptions.setConstraints(incomingVideoConstraints);
4549
```
4650

47-
For *outgoing* video streams, an `OutgoingVideoConstraints` needs to be added to the `OutgoingVideoOptions`.
51+
For *outgoing* video streams, add an `OutgoingVideoConstraints` to the `OutgoingVideoOptions`.
52+
4853
```java
4954
OutgoingVideoConstraints outgoingVideoConstraints = new OutgoingVideoConstraints()
5055
outgoingVideoConstraints.setMaxWidth(/*value*/);
@@ -57,7 +62,8 @@ For *outgoing* video streams, an `OutgoingVideoConstraints` needs to be added to
5762
outgoingVideoOptions.setConstraints(outgoingVideoConstraints);
5863
```
5964

60-
Since the options are used to start/join a call, the constraints can then be applied to the streams automatically. For example:
65+
Since the options are used to start/join a call, you can apply the constraints to the streams automatically. For example:
66+
6167
```java
6268
JoinCallOptions joinCallOptions = new JoinCallOptions();
6369
joinCallOptions.setIncomingVideoOptions(incomingVideoOptions);
@@ -66,7 +72,9 @@ Since the options are used to start/join a call, the constraints can then be app
6672
```
6773

6874
#### Set video constraints during a call
75+
6976
Instead of setting the video constraints before starting a call, you can also dynamically adjust the video constraints during a call. You need to call `setVideoConstraints` on your `Call` type class and provide the constraints.
77+
7078
```java
7179

7280
OutgoingVideoConstraints outgoingVideoConstraints = new OutgoingVideoConstraints();
@@ -85,23 +93,23 @@ Instead of setting the video constraints before starting a call, you can also dy
8593
call.setVideoConstraints(constraints);
8694
```
8795

88-
To reset/remove the video constraints you previously set, you have to follow the above pattern and provide `0` as a constraint value. Providing `null` values for either `IncomingVideoConstraints` or `OutgoingVideoConstraints` won't reset/remove the constraints and the constraints with a `null` value will be ignored.
96+
To reset/remove the video constraints you previously set, follow the preceding pattern and provide `0` as a constraint value. Providing `null` values for either `IncomingVideoConstraints` or `OutgoingVideoConstraints` doesn't reset/remove the constraints and the constraints with a `null` value are ignored.
8997

9098
### Limitations
9199

92100
> [!NOTE]
93-
> Please make sure you are aware of these limitations when using the Video Constraints API.
94-
> Some of the limitations will be removed in future releases.
101+
> Be aware of these limitations when using the Video Constraints API. Some of the limitations should be resolved in future releases.
95102
96103
There are some known limitations to the current Video Constraints API.
97104

98105
* The constraint is a **max** constraint, which means the possible constraint value can be the specified value or smaller. There's no guarantee that the actual value remains the same as user-specified.
99106

100-
* When the user sets a constraint value that is too small, the SDK will use the smallest available value that is supported.
107+
* When the user sets a constraint value that is too small, the SDK uses the smallest available value that is supported.
101108

102109
* For setting `OutgoingVideoConstraints` during a call, the current ongoing video stream doesn't automatically pick up the constraints specified. In order to make the constraints take effect, you need to stop and restart the outgoing video.
103110

104-
* `IncomingVideoConstraints` currently is a user-preferred constraint instead of a hard constraint, which means that depending on your network and hardware, the actual value received may still exceed the constraint set.
111+
* `IncomingVideoConstraints` currently is a user-preferred constraint instead of a hard constraint, which means that depending on your network and hardware, the actual value received might still exceed the constraint set.
105112

106113
### Media stats
107-
To evaluate and compare the video quality after applying the video constraints, you can access [MediaStats API](../../../../concepts/voice-video-calling/media-quality-sdk.md) to get video resolution and bitrate information of the stream. The media stats also include other granular stats related to the streams, such as jitter, packet loss, round trip time, etc.
114+
115+
To evaluate and compare the video quality after applying the video constraints, you can access [MediaStats API](../../../../concepts/voice-video-calling/media-quality-sdk.md) to get video resolution and bitrate information of the stream. The media stats also include other granular stats related to the streams, such as jitter, packet loss, round trip time, and so on.

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

Lines changed: 21 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
ms.author: chengyuanlai
3-
title: Quickstart - Set video constraints in your iOS calling app
3+
title: Set video constraints in an iOS calling app
44
titleSuffix: An Azure Communication Services document
5-
description: In this quickstart, you learn how to set video constraints in your existing iOS calling app using Azure Communication Services.
5+
description: This article describes how to set video constraints in your existing iOS calling app using Azure Communication Services.
66
author: sloanster
77
services: azure-communication-services
8-
ms.date: 07/12/2023
8+
ms.date: 06/26/2025
99
ms.topic: include
1010
ms.service: azure-communication-services
1111
ms.subservice: calling
@@ -14,25 +14,29 @@ ms.subservice: calling
1414
[!INCLUDE [Public Preview](../../../../includes/public-preview-include-document.md)]
1515

1616
## Overview
17+
1718
The Video Constraints API enables developers to control the video quality from within their video calls. In this quickstart guide, we illustrate how to use the API to set the constraints.
1819

1920
### Prerequisites
21+
2022
Refer to the [Voice Calling Quickstart](../../getting-started-with-calling.md?pivots=platform-ios) to set up a sample app with voice calling.
2123

2224
### Classes
25+
2326
| Name | Description |
24-
| - | - |
27+
| --- | --- |
2528
| VideoConstraints | Used to hold both incoming video constraints and outgoing video constraints. |
26-
| OutgoingVideoConstraints | Used to specify constraints (`maxWidth | maxHeight | maxFrameRate`) for outgoing video streams. |
27-
| IncomingVideoConstraints | Used to specify constraints (`maxWidth | maxHeight`) for incoming video streams. |
29+
| OutgoingVideoConstraints | Used to specify constraints (`maxWidth \| maxHeight \| maxFrameRate`) for outgoing video streams. |
30+
| IncomingVideoConstraints | Used to specify constraints (`maxWidth \| maxHeight`) for incoming video streams. |
2831

2932
### Using video constraints
3033

3134
The following sections explain how the video constraints can be set for incoming and/or outgoing video streams at different times of a call.
3235

3336
#### Set video constraints before starting a call
3437

35-
For *incoming* video streams, an `IncomingVideoConstraints` needs to be added to the `IncomingVideoOptions`.
38+
For *incoming* video streams, you need to add an `IncomingVideoConstraints` to the `IncomingVideoOptions`.
39+
3640
```swift
3741
let incomingVideoConstraints = IncomingVideoConstraints()
3842
incomingVideoConstraints.maxWidth = /*value*/
@@ -58,6 +62,7 @@ For *outgoing* video streams, an `OutgoingVideoConstraints` needs to be added to
5862
```
5963

6064
Since the options are used to start/join a call, the constraints can then be applied to the streams automatically. For example:
65+
6166
```swift
6267
let incomingVideoConstraints = IncomingVideoConstraints()
6368
incomingVideoConstraints.maxWidth = /*value*/
@@ -80,7 +85,9 @@ Since the options are used to start/join a call, the constraints can then be app
8085
```
8186

8287
#### Set video constraints during a call
83-
Instead of setting the video constraints before starting a call, you can also dynamically adjust the video constraints during a call. You need to call `set(videoConstraints)` on your `Call` type class and provide the constraints.
88+
89+
Instead of setting the video constraints before starting a call, you can dynamically adjust the video constraints during a call. You need to call `set(videoConstraints)` on your `Call` type class and provide the constraints.
90+
8491
```swift
8592

8693
let outgoingVideoConstraints = OutgoingVideoConstraints()
@@ -99,24 +106,23 @@ Instead of setting the video constraints before starting a call, you can also dy
99106
call?.set(videoConstraints: videoConstraints)
100107
```
101108

102-
To reset/remove the video constraints you previously set, you have to follow the above pattern and provide `0` as a constraint value. Providing `null` values for either `IncomingVideoConstraints` or `OutgoingVideoConstraints` won't reset/remove the constraints and the constraints with a `null` value will be ignored.
103-
109+
To reset/remove the video constraints you previously set, follow the preceding pattern and provide `0` as a constraint value. Providing `null` values for either `IncomingVideoConstraints` or `OutgoingVideoConstraints` doesn't reset/remove the constraints and the constraints with a `null` value are ignored.
104110

105111
### Limitations
106112

107113
> [!NOTE]
108-
> Please make sure you are aware of these limitations when using the Video Constraints API.
109-
> Some of the limitations will be removed in future releases.
114+
> Be aware of these limitations when using the Video Constraints API. Some of the limitations should be resolved in future releases.
110115
111116
There are some known limitations to the current Video Constraints API.
112117

113118
* The constraint is a **max** constraint, which means the possible constraint value can be the specified value or smaller. There's no guarantee that the actual value remains the same as user-specified.
114119

115-
* When the user sets a constraint value that is too small, the SDK will use the smallest available value that is supported.
120+
* When the user sets a constraint value that is too small, the SDK uses the smallest available value that is supported.
116121

117122
* For setting `OutgoingVideoConstraints` during a call, the current ongoing video stream doesn't automatically pick up the constraints specified. In order to make the constraints take effect, you need to stop and restart the outgoing video.
118123

119-
* `IncomingVideoConstraints` currently is a user-preferred constraint instead of a hard constraint, which means that depending on your network and hardware, the actual value received may still exceed the constraint set.
124+
* `IncomingVideoConstraints` currently is a user-preferred constraint instead of a hard constraint, which means that depending on your network and hardware, the actual value received might still exceed the constraint set.
120125

121126
### Media stats
122-
To evaluate and compare the video quality after applying the video constraints, you can access [MediaStats API](../../../../concepts/voice-video-calling/media-quality-sdk.md) to get video resolution and bitrate information of the stream. The media stats also include other granular stats related to the streams, such as jitter, packet loss, round trip time, etc.
127+
128+
To evaluate and compare the video quality after applying the video constraints, you can access [MediaStats API](../../../../concepts/voice-video-calling/media-quality-sdk.md) to get video resolution and bitrate information of the stream. The media stats also include other granular stats related to the streams, such as jitter, packet loss, round trip time, and so on.

0 commit comments

Comments
 (0)