You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/communication-services/how-tos/calling-sdk/powerpoint-live.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,9 +14,9 @@ ms.custom: template-how-to
14
14
15
15
# View PowerPoint Live presentations
16
16
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.
18
18
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.
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/voice-video-calling/includes/video-constraints/video-constraints-android.md
+25-17Lines changed: 25 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
1
---
2
2
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.
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.
18
19
19
20
### Prerequisites
21
+
20
22
Refer to the [Voice Calling Quickstart](../../getting-started-with-calling.md?pivots=platform-android) to set up a sample app with voice calling.
21
23
22
24
### Classes
25
+
23
26
| Name | Description |
24
-
| - | - |
27
+
| ---|--- |
25
28
| 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. |
28
31
29
32
### Using video constraints
30
33
31
34
The following sections explain how the video constraints can be set for incoming and/or outgoing video streams at different times of a call.
32
35
33
36
#### Set video constraints before starting a call
34
37
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`.
@@ -66,7 +72,9 @@ Since the options are used to start/join a call, the constraints can then be app
66
72
```
67
73
68
74
#### Set video constraints during a call
75
+
69
76
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.
@@ -85,23 +93,23 @@ Instead of setting the video constraints before starting a call, you can also dy
85
93
call.setVideoConstraints(constraints);
86
94
```
87
95
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.
89
97
90
98
### Limitations
91
99
92
100
> [!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.
95
102
96
103
There are some known limitations to the current Video Constraints API.
97
104
98
105
* 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.
99
106
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.
101
108
102
109
* 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.
103
110
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.
105
112
106
113
### 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.
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/voice-video-calling/includes/video-constraints/video-constraints-ios.md
+21-15Lines changed: 21 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
1
---
2
2
ms.author: chengyuanlai
3
-
title: Quickstart - Set video constraints in your iOS calling app
3
+
title: Set video constraints in an iOS calling app
4
4
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.
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.
18
19
19
20
### Prerequisites
21
+
20
22
Refer to the [Voice Calling Quickstart](../../getting-started-with-calling.md?pivots=platform-ios) to set up a sample app with voice calling.
21
23
22
24
### Classes
25
+
23
26
| Name | Description |
24
-
| - | - |
27
+
| ---|--- |
25
28
| 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. |
28
31
29
32
### Using video constraints
30
33
31
34
The following sections explain how the video constraints can be set for incoming and/or outgoing video streams at different times of a call.
32
35
33
36
#### Set video constraints before starting a call
34
37
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
+
36
40
```swift
37
41
let incomingVideoConstraints =IncomingVideoConstraints()
38
42
incomingVideoConstraints.maxWidth=/*value*/
@@ -58,6 +62,7 @@ For *outgoing* video streams, an `OutgoingVideoConstraints` needs to be added to
58
62
```
59
63
60
64
Since the options are used to start/join a call, the constraints can then be applied to the streams automatically. For example:
65
+
61
66
```swift
62
67
let incomingVideoConstraints =IncomingVideoConstraints()
63
68
incomingVideoConstraints.maxWidth=/*value*/
@@ -80,7 +85,9 @@ Since the options are used to start/join a call, the constraints can then be app
80
85
```
81
86
82
87
#### 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
+
84
91
```swift
85
92
86
93
let outgoingVideoConstraints =OutgoingVideoConstraints()
@@ -99,24 +106,23 @@ Instead of setting the video constraints before starting a call, you can also dy
99
106
call?.set(videoConstraints: videoConstraints)
100
107
```
101
108
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.
104
110
105
111
### Limitations
106
112
107
113
> [!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.
110
115
111
116
There are some known limitations to the current Video Constraints API.
112
117
113
118
* 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.
114
119
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.
116
121
117
122
* 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.
118
123
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.
120
125
121
126
### 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