network and video effects

Author: vac0224

articles/communication-services/concepts/voice-video-calling/network-requirements.md

@@ -1,12 +1,12 @@
 ---
-title: Prepare your organization's network for Azure Communication Services
-description: Learn about the network requirements for Azure Communication Services voice and video calling.
+title: Network recommendations
+titleSuffix: An Azure Communication Services article
+description: This article describes the network requirements for Azure Communication Services voice and video calling.
 author: nmurav
 manager: chpalm
 services: azure-communication-services
-
 ms.author: nmurav
-ms.date: 02/19/2024
+ms.date: 06/20/2025
 ms.topic: conceptual
 ms.service: azure-communication-services
 ms.subservice: calling
@@ -15,7 +15,7 @@ ms.custom: devx-track-js
 
 # Network recommendations
 
-This article summarizes how the network environment affects voice and video calling quality. Many factors contribute to the quality of Azure Communication Services real-time media that includes audio, video, and application sharing. Some of the factors include network quality and bandwidth, firewall, host, and device configurations.
+This article describes how the network environment affects voice and video calling quality. Many factors contribute to the quality of Azure Communication Services real-time media including audio, video, and application sharing. Some of the factors include network quality and bandwidth, firewall, host, and device configurations.
 
 ## Network quality
 
@@ -92,7 +92,7 @@ Validate NAT pool size | Validate the NAT pool size required for user connectivi
 | Intrusion detection and prevention guidance | If your environment has an [intrusion detection system](../../../network-watcher/network-watcher-intrusion-detection-open-source-tools.md) or intrusion prevention system deployed for an extra layer of security for outbound connections, allow all Communication Services URLs. |
 | Configure split-tunnel VPN | Provide an alternate path for Teams traffic that bypasses the virtual private network (VPN), commonly known as [split-tunnel VPN](/windows/security/identity-protection/vpn/vpn-routing). Split tunneling means that traffic for Communication Services doesn't go through the VPN but instead goes directly to Azure. Bypassing your VPN has a positive impact on media quality, and it reduces load from the VPN devices and the organization's network. To implement a split-tunnel VPN, work with your VPN vendor. Other reasons why we recommend bypassing the VPN: <ul><li> VPNs are typically not designed or configured to support real-time media.</li><li> VPNs might also not support UDP, which is required for Communication Services.</li><li>VPNs also introduce an extra layer of encryption on top of media traffic that's already encrypted.</li><li>Connectivity to Communication Services might not be efficient because of hair-pinning traffic through a VPN device.</li></ul>|
 | Implement QoS | [Use Quality of Service (QoS)](/microsoftteams/qos-in-teams) to configure packet prioritization. QoS improves call quality and helps you monitor and troubleshoot call quality. QoS should be implemented on all segments of a managed network. Even when a network is adequately provisioned for bandwidth, QoS provides risk mitigation if unanticipated network events occur. With QoS, voice traffic is prioritized so that these unanticipated events don't negatively affect quality. | 
-| Optimize Wi-Fi | Similar to VPN, Wi-Fi networks aren't necessarily designed or configured to support real-time media. Planning for, or optimizing, a Wi-Fi network to support Communication Services is an important consideration for a high-quality deployment. Consider these factors: <ul><li>Implement QoS or Wi-Fi Multimedia to ensure that media traffic is getting prioritized appropriately over your Wi-Fi networks.</li><li>Plan and optimize the Wi-Fi bands and access point placement. The 2.4-GHz range might provide an adequate experience depending on access point placement. Other consumer devices that operate in that range can also negatively affect access points. The 5-GHz range is better suited to real-time media because of its dense range, but it requires more access points to get sufficient coverage. Endpoints also need to support that range and configured to use those bands accordingly.</li><li>If you're using dual-band Wi-Fi networks, consider implementing band steering. Band steering is a technique implemented by Wi-Fi vendors to influence dual-band clients to use the 5-GHz range.</li><li>When access points of the same channel are too close together, they can cause signal overlap and unintentionally compete, which results in a degraded user experience. Ensure that access points next to each other are on channels that don't overlap.</li></ul> Each wireless vendor has its own recommendations for deploying its wireless solution. Consult your Wi-Fi vendor for specific guidance.|
+| Optimize Wi-Fi | Similar to VPN, Wi-Fi networks aren't necessarily designed or configured to support real-time media. It's important for you to optimize a Wi-Fi network to support Communication Services, ensuring a high-quality deployment. Consider these factors: <ul><li>Implement QoS or Wi-Fi Multimedia to ensure that media traffic is getting prioritized appropriately over your Wi-Fi networks.</li><li>Plan and optimize the Wi-Fi bands and access point placement. The 2.4-GHz range might provide an adequate experience depending on access point placement. Other consumer devices that operate in that range can also negatively affect access points. The 5-GHz range is better suited to real-time media because of its dense range, but it requires more access points to get sufficient coverage. Endpoints also need to support that range and configured to use those bands accordingly.</li><li>If you're using dual-band Wi-Fi networks, consider implementing band steering. Band steering is a technique implemented by Wi-Fi vendors to influence dual-band clients to use the 5-GHz range.</li><li>When access points of the same channel are too close together, they can cause signal overlap and unintentionally compete, which results in a degraded user experience. Ensure that access points next to each other are on channels that don't overlap.</li></ul> Each wireless vendor has its own recommendations for deploying its wireless solution. Consult your Wi-Fi vendor for specific guidance.|
 
 ## Operating systems and browsers (for JavaScript SDKs)
 

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

@@ -1,7 +1,7 @@
 ---
 ms.author: micahvivion
 title: Azure Communication Services Calling video WebJS video effects
-titleSuffix: An Azure Communication Services document
+titleSuffix: An Azure Communication Services article
 description: In this document, you learn how to create video effects on an Azure Communication Services call.
 author: sloanster
 services: azure-communication-services

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

@@ -1,28 +1,31 @@
 ---
-title: PowerPoint Live
-titleSuffix: An Azure Communication Services how-to guide
+title: View PowerPoint Live presentations
+titleSuffix: An Azure Communication Services article
 description: Use Azure Communication Services SDKs to view PowerPoint Live presentations.
 author: jamescadd
 manager: chpalm
 ms.author: jacadd
 ms.service: azure-communication-services
 ms.subservice: calling
 ms.topic: how-to 
-ms.date: 11/10/2023
+ms.date: 06/20/2025
 ms.custom: template-how-to
 ---
 
 # View PowerPoint Live presentations
-In this article, you learn how to implement viewing a [PowerPoint Live presentation 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. 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.
+
+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.
+
+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.
 
 ## Prerequisites
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
 - A deployed Communication Services resource. [Create a Communication Services resource](../../quickstarts/create-communication-resource.md).
 - A user access token to enable the calling client. For more information, see [Create and manage access tokens](../../quickstarts/identity/access-tokens.md).
-- Optional: Complete the quickstart to [add voice calling to your application](../../quickstarts/voice-video-calling/getting-started-with-calling.md)
+- Optional: Complete the quickstart to [add voice calling to your application](../../quickstarts/voice-video-calling/getting-started-with-calling.md).
 
-PowerPoint Live viewing is an extended feature of the core `Call` API. You first need to import calling Features from the Calling SDK:
+PowerPoint Live viewing is an extended feature of the core `Call` API. You first need to import calling features from the Calling SDK:
 
 ```js
 import { Features}  from "@azure/communication-calling";
@@ -35,13 +38,15 @@ const pptLive = call.feature(SDK.Features.PPTLive);
 ```
 
 ### Handle presentation state changes
-With the `PPTLiveCallFeature` API, you can subscribe to the `isActiveChanged` event to handle changes to the state of a PowerPoint Live presentation on a call. This event is triggered by a presenter in Microsoft Teams and `isActive` indicates if PowerPoint Live is active in the current call.
+
+With the `PPTLiveCallFeature` API object, you can subscribe to the `isActiveChanged` event to handle changes to the state of a PowerPoint Live presentation on a call. A presenter in Microsoft Teams triggers this event and `isActive` indicates if PowerPoint Live is active in the current call.
 
 ```js
 pptLive.on('isActiveChanged', pptliveStateChangedHandler);
 ```
 
 ### Start and stop presentation viewing
+
 Add the `target` element to your HTML when the presentation starts and remove it when the presentation stops.
 
 ```js
@@ -56,19 +61,22 @@ const pptliveStateChangedHandler = () => {
 ```
 
 ### Stop handling presentation state changes
+
 Your application can unsubscribe from `isActiveChanged` to stop listening to presentation events.
 
 ```js
 pptLive.off('isActiveChanged', pptliveStateChangedHandler);
 ```
 
 ### Key things to know when using PowerPoint Live viewing
-- Switching to [screen sharing](./manage-calls.md) is recommended if any issues are experienced with PowerPoint Live viewing.
+
+- We recommend switching to [screen sharing](./manage-calls.md) if any attendees experience issues viewing PowerPoint Live.
 - PowerPoint Live is supported in the Web Calling SDK.
 - PowerPoint Live is supported for Microsoft Teams Meeting interoperability.
 - Microsoft Teams must be used to present PowerPoint Live.
 
 ## Next steps
+
 - [Learn how to manage calls and use screen sharing](./manage-calls.md)
 - [Learn how to manage video](./manage-video.md)
 - [Learn how to use reactions](./reactions.md)

articles/communication-services/how-tos/cte-calling-sdk/includes/shared-line-appearance/shared-line-appearance-web.md

@@ -9,13 +9,13 @@ ms.custom:
 ---
 
 > [!NOTE]
-> This API is available with Azure Communication Services Calling Web SDK (1.35.1 or higher).
+> This API feature is available with Azure Communication Services Calling Web SDK (1.35.1 or higher).
 
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-web.md)]
 
 ## Place a call on behalf of a Microsoft Teams user
 
-Before placing a call behalf of a delegator, make sure delegate placing the call has `make calls` permission through [delegator call settings in Microsoft Teams](https://support.microsoft.com/office/share-a-phone-line-with-a-delegate-in-microsoft-teams-16307929-a51f-43fc-8323-3b1bf115e5a8)
+Before placing a call behalf of a delegator, make sure delegate placing the call has `make calls` permission through [delegator call settings in Microsoft Teams](https://support.microsoft.com/office/share-a-phone-line-with-a-delegate-in-microsoft-teams-16307929-a51f-43fc-8323-3b1bf115e5a8).
 
 To place a call on behalf of a Microsoft Teams user, specify `OnBehalfOfOptions` during start call. Replace `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` with the userId of the delegator and `yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy` with the userId of the callee.
 
@@ -25,15 +25,15 @@ const teamsCallOptions = { onBehalfOfOptions: onBehalfOfOptions };
 const call = teamsCallAgent.startCall([{ microsoftTeamsUserId: "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy" }], teamsCallOptions);
 ```
 
-To place a call to a PSTN user on behalf of a Microsoft Teams user, use `PhoneNumberIdentifier` for call participant.
+To place a call to a pubic switched telephone network (PSTN) user on behalf of a Microsoft Teams participant, use `PhoneNumberIdentifier` for call participant.
 
 ```js
 const call = teamsCallAgent.startCall([{ phoneNumber: "+1xxxxxxxxxx" }], teamsCallOptions);
 ```
 
 ## Receive a call on behalf of a Microsoft Teams user
 
-To receive calls on behalf of a delegator,
+To receive calls on behalf of a delegator:
 
-- Update delegate permission to enable "receive calls" through [delegator call settings in Microsoft Teams](https://support.microsoft.com/office/share-a-phone-line-with-a-delegate-in-microsoft-teams-16307929-a51f-43fc-8323-3b1bf115e5a8)
-- Set up simultaneous ring for delegates through [delegator call settings in Microsoft Teams](https://support.microsoft.com/office/call-forwarding-call-groups-and-simultaneous-ring-in-microsoft-teams-a88da9e8-1343-4d3c-9bda-4b9615e4183e)
+- Update delegate permission to enable the *receive calls* setting through [delegator call settings in Microsoft Teams](https://support.microsoft.com/office/share-a-phone-line-with-a-delegate-in-microsoft-teams-16307929-a51f-43fc-8323-3b1bf115e5a8).
+- Set up simultaneous ring for delegates through [delegator call settings in Microsoft Teams](https://support.microsoft.com/office/call-forwarding-call-groups-and-simultaneous-ring-in-microsoft-teams-a88da9e8-1343-4d3c-9bda-4b9615e4183e).

articles/communication-services/how-tos/cte-calling-sdk/shared-line-appearance.md

@@ -10,24 +10,26 @@ ms.date: 02/04/2025
 
 # Teams Shared Line Appearance
 
-This article describes how to implement Microsoft Teams Shared Line Appearance with Azure Communication Services. Shared line appearance lets a user choose a delegate to make or handle calls on their behalf. This feature is helpful if a user has an administrative assistant who regularly handles the user's calls. In the context of shared line appearance, a manager is a Teams user who authorizes a delegate to make or receive calls on their behalf. A delegate is a Microsoft 365 user who can make or receive calls on behalf of the delegator. You can find additional information about shared line appearance in [Teams documentation](/microsoftteams/shared-line-appearance).
+This article describes how to implement Microsoft Teams Shared Line Appearance with Azure Communication Services. Shared line appearance lets a user choose a delegate to make or handle calls on their behalf. This feature is helpful if a user has an administrative assistant who regularly handles the user's calls.
+
+In the context of shared line appearance, a manager is a Teams user who authorizes a delegate to make or receive calls on their behalf. A delegate is a Microsoft 365 user who can make or receive calls on behalf of the delegator. For more information, see [Share line appearance](/microsoftteams/shared-line-appearance).
 
 ## Prerequisites
 
 - An Azure account with an active subscription. See [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
 - A deployed Communication Services resource. See [Create a Communication Services resource](../../quickstarts/create-communication-resource.md).
 - A user access token to enable the calling client. For more information, see [Create and manage access tokens](../../quickstarts/identity/access-tokens.md).
 - Licensing requirements for delegator and delegates. See [Teams Phone license](/microsoftteams/shared-line-appearance#license-required).
-- Enable delegation and shared line appearance. See [Enable delegation](/microsoftteams/shared-line-appearance#enable-delegation-and-shared-line-appearance)
+- Enable delegation and shared line appearance. See [Enable delegation](/microsoftteams/shared-line-appearance#enable-delegation-and-shared-line-appearance).
 - Assign delegates using [Microsoft Teams Client](https://support.microsoft.com/office/share-a-phone-line-with-a-delegate-in-microsoft-teams-16307929-a51f-43fc-8323-3b1bf115e5a8) or [Teams PowerShell](/microsoftteams/shared-line-appearance#use-powershell).
-- Learn more about [Team Shared Line Appearance in Azure Communication Services](../../concepts/interop/teams-user/teams-shared-line-appearance.md)
+- Learn more about [Team Shared Line Appearance in Azure Communication Services](../../concepts/interop/teams-user/teams-shared-line-appearance.md).
 - Optional: Complete the quickstart to add voice calling to Microsoft Teams user. See [Quickstart: Add voice calling to Microsoft Teams user](../../quickstarts/voice-video-calling/get-started-call-to-teams-user.md).
 
 ## Support
 
 ### SDKs
 
-The following table shows support for shared line appearance feature in individual Azure Communication Services SDKs.
+The following table shows support for the shared line appearance feature in individual Azure Communication Services SDKs.
 
 | Support status | Web | Web UI | iOS | iOS UI | Android | Android UI | Windows |
 |----------------|-----|--------|--------|--------|----------|--------|---------|