Merge pull request #301947 from vac0224/vc-toc-reconcileX-2025-06-28

Reconcile titles with TOC (10)

Author: v-ccolin

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

@@ -1,33 +1,40 @@
 ---
-title: Azure Communication Services Simulcast
-titleSuffix: An Azure Communication Services concept document
-description: Overview of Simulcast - how sending multiple video quality streams helps overall call quality.
+title: Simulcast
+titleSuffix: An Azure Communication Services article
+description: This article describes how to send multiple video quality streams helps overall call quality.
 author: sloanster
 manager: chpalm
 services: azure-communication-services
 
 ms.author: micahvivion
-ms.date: 02/19/2024
+ms.date: 06/26/2025
 ms.topic: conceptual
 ms.subservice: calling
 ms.service: azure-communication-services
 ---
-# What is Simulcast?
-Simulcast is a technique that allows video streaming applications to send multiple versions of the same video content at different resolutions and bitrates. This way, the receiver can choose the most suitable version based on their network conditions and device capabilities. 
+# Simulcast
 
-The lack of simulcast support leads to a degraded video experience in calls with three or more participants. If a video receiver with poor network conditions joins the conference, it impacts the quality of video received from the sender without simulcast support for all other participants. The video sender optimizes its video feed against the lowest common denominator. When simulcast streaming is available the potential impact of one person affecting the entire streaming quality experience is minimized.
+Simulcast is a technique that enables video streaming applications to send multiple versions of the same video content at different resolutions and bitrates. This way, the receiver can choose the most suitable version based on their network conditions and device capabilities. 
 
-Simulcast is supported on Azure Communication Services SDK for WebJS (1.9.1-beta.1+) and native SDK for Android, iOS, and Windows. Currently, simulcast on the sender side is supported on following desktop browsers - Chrome and Edge. Simulcast on receiver side is supported on all platforms that Azure Communication Services Calling supports. Support for Sender side Simulcast capability from mobile browsers will be added in the future.
+The lack of simulcast support leads to a degraded video experience in calls with three or more participants. If a video receiver with poor network conditions joins the conference, it impacts the quality of video received from the sender without simulcast support for all other participants. The video sender optimizes its video feed against the lowest common denominator. When simulcast streaming is available, the potential impact of one person affecting the entire streaming quality experience is minimized.
 
-## How Simulcast works
-Simulcast is a feature that allows a publisher, in this case the Azure Communication Services calling SDK, to send different qualities of the same video to the SFU. The SFU then forwards the most suitable quality to each other endpoint on a call, based on their bandwidth, CPU, and resolution preferences. This way, the publisher can save resources and the subscribers can receive the best possible quality. The SFU doesn't change the video quality, it only selects which one to forward.
+Simulcast is supported on Azure Communication Services SDK for WebJS (1.9.1-beta.1+) and native SDK for Android, iOS, and Windows. Currently, simulcast on the sender side is supported on following desktop browsers - Chrome and Microsoft Edge. Simulcast on receiver side is supported on all platforms that Azure Communication Services Calling supports. Support for Sender side Simulcast capability from mobile browsers is planned for a future release.
+
+## How simulcast works
+
+The simulcast feature enables a publisher, in this case the Azure Communication Services calling SDK, to send different qualities of the same video to the selective forwarding unit (SFU). The SFU then forwards the most suitable quality to each other endpoint on a call, based on their bandwidth, CPU, and resolution preferences. This way, the publisher can save resources and the subscribers can receive the best possible quality. The SFU doesn't change the video quality. The SFU only selects which one to forward.
+
+## Supported number of video qualities available with Simulcast
 
-## Supported number of video qualities available with Simulcast.
 Simulcast streaming from a web endpoint supports a maximum two video qualities. There aren't API controls needed to enable Simulcast for Azure Communication Services. Simulcast is enabled and available for all video calls.
 
 ## Available video resolutions
-When streaming with simulcast, there are no set resolutions for high or low quality simulcast video streams. Instead, based on many different variables, either a single or multiple video steams are delivered. If every subscriber to video is requesting and capable of receiving maximum resolution what publisher can provide, only that maximum resolution will be sent. The following resolutions are supported:
-- 1080P
+
+When a participant is streaming with simulcast, there are no set resolutions for high or low quality simulcast video streams. Instead, based on many different variables, either a single or multiple video steams are delivered. If every subscriber to video is requesting and capable of receiving maximum resolution what publisher can provide, only that it sends maximum resolution.
+
+Simulcast supports the following resolutions:
+
+- 1080p
 - 720p
 - 540p
 - 360p

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

@@ -14,9 +14,9 @@ ms.custom: template-how-to
 
 # View PowerPoint Live presentations
 
-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.
+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.
 
-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.
+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.
 
 ## Prerequisites
 

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

@@ -1,19 +1,20 @@
 ---
-ms.author: micahvivion
-title: Quickstart - Set video constraints in your calling app
-titleSuffix: An Azure Communication Services quickstart
-description: In this quickstart, you learn how to set video constraints in your existing calling app using Azure Communication Services.
+
+title: Set video constraints in a calling app
+titleSuffix: An Azure Communication Services article
+description: This article describes how to set video constraints in your existing calling app using Azure Communication Services.
 author: sloanster
+ms.author: micahvivion
 services: azure-communication-services
-ms.date: 02/18/2024
+ms.date: 06/26/2025
 ms.topic: quickstart
 ms.service: azure-communication-services
 ms.subservice: calling
 zone_pivot_groups: acs-plat-web-ios-android-windows
 ms.custom: mode-other, devx-track-js
 ---
 
-# Quickstart: Set video constraints in your calling app
+# Set video constraints in a calling app
 
 ::: zone pivot="platform-windows"
 [!INCLUDE [Set video constraints with Windows](./includes/video-constraints/video-constraints-windows.md)]
@@ -30,9 +31,9 @@ ms.custom: mode-other, devx-track-js
 ::: zone pivot="platform-web"
 [!INCLUDE [Set video constraints with JavaScript](./includes/video-constraints/video-constraints-javascript.md)]
 ::: zone-end
-## Next steps
 
-For more information, see the following articles:
+
+## Next steps
 
 - Learn about [Video Constraints concept document](../../concepts/voice-video-calling/video-constraints.md)
 - Learn more about [Calling SDK capabilities](./getting-started-with-calling.md)

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

@@ -1,7 +1,7 @@
 ---
-title: Add video effects to your video calls
+title: Enable video background effects
 titleSuffix: An Azure Communication Services article
-description: Learn how to add video effects in your video calls using Azure Communication Services.
+description: This article describes how to add video effects in your video calls using Azure Communication Services.
 author: sloanster
 
 ms.author: micahvivion
@@ -14,7 +14,7 @@ zone_pivot_groups: acs-plat-web-ios-android-windows
 ms.custom: mode-other, devx-track-js
 ---
 
-# Add video effects to your video calls
+# Enable video background effects
 
 ::: zone pivot="platform-web"
 [!INCLUDE [Video effects with JavaScript](./includes/video-effects/video-effects-javascript.md)]
@@ -32,10 +32,9 @@ ms.custom: mode-other, devx-track-js
 [!INCLUDE [Video effects with Android](./includes/video-effects/video-effects-windows.md)]
 ::: zone-end
 
-
 ## Next steps
 
-- Check out our [calling hero sample](../../samples/calling-hero-sample.md)
-- Get started with the [UI Library](../../concepts/ui-library/ui-library-overview.md)
-- Learn about [Calling SDK capabilities](./getting-started-with-calling.md?pivots=platform-web)
-- Learn more about [how calling works](../../concepts/voice-video-calling/about-call-types.md) 
+- Check out our [calling hero sample](../../samples/calling-hero-sample.md).
+- Get started with the [UI Library](../../concepts/ui-library/ui-library-overview.md).
+- Learn about [Calling SDK capabilities](./getting-started-with-calling.md?pivots=platform-web).
+- Learn more about [how calling works](../../concepts/voice-video-calling/about-call-types.md).

articles/communication-services/quickstarts/voice-video-calling/includes/local-preview-mirroring/local-preview-mirroring-android.md

@@ -1,12 +1,12 @@
 ---
-title: Quickstart - Turn off local preview mirroring
-titleSuffix: An Azure Communication Services Quickstart
-description: This quickstart describes how to turn off local preview mirroring
+title: Turn off local preview mirroring
+titleSuffix: An Azure Communication Services article
+description: This article describes how to turn off local preview mirroring
 author: yassirbisteni
 manager: gaobob
 
 ms.author: yassirb
-ms.date: 2/21/2025
+ms.date: 6/26/2025
 ms.topic: quickstart
 ms.service: azure-communication-services
 ms.subservice: calling
@@ -15,7 +15,7 @@ ms.custom: mode-other, devx-track-js
 zone_pivot_groups: acs-plat-web-windows-android-ios
 ---
 
-### Turn off local preview mirroring
+### Code to turn off local preview mirroring
 
 ````java
 VideoStreamRenderer renderer = new VideoStreamRenderer(localVideoStream, this);

articles/communication-services/quickstarts/voice-video-calling/includes/local-preview-mirroring/local-preview-mirroring-ios.md

@@ -1,12 +1,12 @@
 ---
-title: Quickstart - Turn off local preview mirroring
-titleSuffix: An Azure Communication Services Quickstart
-description: This quickstart describes how to turn off local preview mirroring
+title: Turn off local preview mirroring
+titleSuffix: An Azure Communication Services article
+description: This article describes how to turn off local preview mirroring.
 author: yassirbisteni
 manager: gaobob
 
 ms.author: yassirb
-ms.date: 2/21/2025
+ms.date: 6/26/2025
 ms.topic: quickstart
 ms.service: azure-communication-services
 ms.subservice: calling
@@ -15,7 +15,7 @@ ms.custom: mode-other, devx-track-js
 zone_pivot_groups: acs-plat-web-windows-android-ios
 ---
 
-### Turn off local preview mirroring
+### Code to turn off local preview mirroring
 
 ````swift
 var renderer = try VideoStreamRenderer(localVideoStream: localVideoStream)

articles/communication-services/quickstarts/voice-video-calling/includes/local-preview-mirroring/local-preview-mirroring-windows.md

@@ -1,12 +1,12 @@
 ---
-title: Quickstart - Turn off local preview mirroring
-titleSuffix: An Azure Communication Services Quickstart
-description: This quickstart describes how to turn off local preview mirroring
+title: Turn off local preview mirroring
+titleSuffix: An Azure Communication Services article
+description: This article describes how to turn off local preview mirroring.
 author: yassirbisteni
 manager: gaobob
 
 ms.author: yassirb
-ms.date: 2/21/2025
+ms.date: 6/26/2025
 ms.topic: quickstart
 ms.service: azure-communication-services
 ms.subservice: calling
@@ -15,7 +15,7 @@ ms.custom: mode-other, devx-track-js
 zone_pivot_groups: acs-plat-web-windows-android-ios
 ---
 
-### Turn off local preview mirroring
+### Code to turn off local preview mirroring
 
 ````csharp
 var uri = await localOutgoingVideoStream.StartPreviewAsync();

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

@@ -1,11 +1,11 @@
 ---
 ms.author: chengyuanlai
-title: Quickstart - Set video constraints in your Android calling app
-titleSuffix: An Azure Communication Services document
-description: In this quickstart, you learn how to set video constraints in your existing Android calling app using Azure Communication Services.
+title: Set video constraints in an Android calling app
+titleSuffix: An Azure Communication Services article
+description: This article describes how to set video constraints in your existing Android calling app using Azure Communication Services.
 author: sloanster
 services: azure-communication-services
-ms.date: 07/10/2023
+ms.date: 06/26/2025
 ms.topic: include
 ms.service: azure-communication-services
 ms.subservice: calling
@@ -14,25 +14,29 @@ ms.subservice: calling
 [!INCLUDE [Public Preview](../../../../includes/public-preview-include-document.md)]
 
 ## Overview
-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.
+
+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.
 
 ### Prerequisites
+
 Refer to the [Voice Calling Quickstart](../../getting-started-with-calling.md?pivots=platform-android) to set up a sample app with voice calling.
 
 ### Classes
+
 | Name | Description |
-| - | - | 
+| --- | --- | 
 | VideoConstraints | Used to hold both incoming video constraints and outgoing video constraints. |
-| OutgoingVideoConstraints | Used to specify constraints (`maxWidth | maxHeight | maxFrameRate`) for outgoing video streams. | 
-| IncomingVideoConstraints | Used to specify constraints (`maxWidth | maxHeight`) for incoming video streams. | 
+| OutgoingVideoConstraints | Used to specify constraints (`maxWidth \| maxHeight \| maxFrameRate`) for outgoing video streams. | 
+| IncomingVideoConstraints | Used to specify constraints (`maxWidth \| maxHeight`) for incoming video streams. | 
 
 ### Using video constraints
 
 The following sections explain how the video constraints can be set for incoming and/or outgoing video streams at different times of a call.
 
 #### Set video constraints before starting a call
 
-For *incoming* video streams, an `IncomingVideoConstraints` needs to be added to the `IncomingVideoOptions`.
+For *incoming* video streams, you need to add an `IncomingVideoConstraints` to the `IncomingVideoOptions`.
+
 ```java
     IncomingVideoConstraints incomingVideoConstraints = new IncomingVideoConstraints();
     incomingVideoConstraints.setMaxWidth(/*value*/);
@@ -44,7 +48,8 @@ For *incoming* video streams, an `IncomingVideoConstraints` needs to be added to
     incomingVideoOptions.setConstraints(incomingVideoConstraints);
 ```
 
-For *outgoing* video streams, an `OutgoingVideoConstraints` needs to be added to the `OutgoingVideoOptions`.
+For *outgoing* video streams, add an `OutgoingVideoConstraints` to the `OutgoingVideoOptions`.
+
 ```java
     OutgoingVideoConstraints outgoingVideoConstraints = new OutgoingVideoConstraints() 
     outgoingVideoConstraints.setMaxWidth(/*value*/); 
@@ -57,7 +62,8 @@ For *outgoing* video streams, an `OutgoingVideoConstraints` needs to be added to
     outgoingVideoOptions.setConstraints(outgoingVideoConstraints);
 ```
 
-Since the options are used to start/join a call, the constraints can then be applied to the streams automatically. For example:
+Since the options are used to start/join a call, you can apply the constraints to the streams automatically. For example:
+
 ```java
     JoinCallOptions joinCallOptions = new JoinCallOptions();
     joinCallOptions.setIncomingVideoOptions(incomingVideoOptions);
@@ -66,7 +72,9 @@ Since the options are used to start/join a call, the constraints can then be app
 ```
 
 #### Set video constraints during a call
+
 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.
+
 ```java
 
     OutgoingVideoConstraints outgoingVideoConstraints = new OutgoingVideoConstraints();
@@ -85,23 +93,23 @@ Instead of setting the video constraints before starting a call, you can also dy
     call.setVideoConstraints(constraints);
 ```
 
-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. 
+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. 
 
 ### Limitations
 
 > [!NOTE]
-> Please make sure you are aware of these limitations when using the Video Constraints API. 
-> Some of the limitations will be removed in future releases.
+> Be aware of these limitations when using the Video Constraints API. Some of the limitations should be resolved in future releases.
 
 There are some known limitations to the current Video Constraints API. 
 
 * 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.
 
-* When the user sets a constraint value that is too small, the SDK will use the smallest available value that is supported.
+* When the user sets a constraint value that is too small, the SDK uses the smallest available value that is supported.
 
 * 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.
 
-* `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.
+* `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.
 
 ### Media stats
-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.
+
+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.