Update web.md

sloanster · web-flow · commit ffcb74a50033 · 2025-06-27T14:37:14.000-07:00
diff --git a/articles/communication-services/tutorials/audio-quality-enhancements/includes/web.md b/articles/communication-services/tutorials/audio-quality-enhancements/includes/web.md
@@ -6,44 +6,84 @@ author: sloanster
 ms.author: micahvivion
 
 services: azure-communication-services
-ms.date: 11/05/2024
+ms.date: 06/28/2025
 ms.topic: include
 ms.service: azure-communication-services
 ms.subservice: calling
 ---
 
-The Azure Communication Services audio effects *noise suppression* abilities can improve your audio calls by filtering out unwanted background noises. Noise suppression is a technology that removes background noises from audio calls. Eliminating background noise makes it easier to talk and listen. Noise suppression can also reduce distractions and tiredness caused by noisy places. For example, if you're taking an Azure Communication Services WebJS call in a noisy coffee shop, turning on noise suppression can make the call experience better.
+The Azure Communication Services audio effects features can significantly enhance your audio calls by filtering out unwanted background noise and removing echo. Noise suppression works by identifying and eliminating distracting sounds like traffic, typing, or chatter, making conversations clearer and easier to follow. At the same time, echo removal ensures your voice doesn’t bounce back during the call, reducing feedback and preventing interruptions. These technologies not only improve speech clarity but also reduce listener fatigue—especially in noisy environments. For instance, if you're on an Azure Communication Services WebJS call in a busy coffee shop, enabling these audio effects can create a smoother, more focused communication experience
+
+## 🎧 What Are Audio Effects?
+Audio effects in ACS are real-time enhancements applied to microphone input during a call. The Azure Communications Services audio effects package has multiple abilities to remove unwanted sounds from a call (from a client perspective).
+
+1. **Noise suppression** (sometimes called noise reduction) focuses on eliminating unwanted background sounds. Think typing sounds, fan hums, distant conversations, or street noise. Its job is to isolate your voice so that whoever is listening hears you more clearly, and reduce or remove the distracting background sounds. It uses algorithms trained to recognize the difference between your speech and ambient noise, then reduces or removes that noise in real time.
+Key traits that noise suppression does:
+- Removes continuous or predictable noises.
+- Enhances speech clarity.
+- Typically works on the speaker’s end before sending the audio out.
+
+2. **Echo cancellation** eliminates echo caused when your microphone picks up audio from your speakers. For example, when someone is on speakerphone and their microphone picks up your voice from their speaker, it can loop back to you as an echo. Echo cancellation predicts and subtracts this returning sound so you don’t hear yourself talking back a fraction of a second later.
+Key traits for echo cancelation:
+- Eliminates acoustic feedback.
+- Essential in speakerphone or open mic setups.
+- Reduces listener fatigue and confusion caused by hearing your own voice returned.
 
 ## Use audio effects: Install the calling effects npm package
 
 > [!IMPORTANT]
-> This tutorial employs the Azure Communication Services Calling SDK version `1.28.4` or later, alongside the Azure Communication Services Calling Effects SDK version `1.1.2` or later. The general availability (GA) stable version `1.28.4` and later of the Calling SDK support noise suppression features. Alternatively, if you opt to use the public preview version, Calling SDK versions `1.24.2-beta.1` and later also support noise suppression.
-> 
-> Current browser support for adding audio noise suppression effects is available only on Chrome and Edge desktop browsers.
+> **Noise Suppression** features are available in GA SDK version `1.28.4` or later, alongside the Azure Communication Services Calling Effects SDK version GA `1.1.2` or later. The general availability (GA) stable version `1.28.4` and later of the Calling SDK support noise suppression features. Alternatively, if you opt to use the public preview version, Calling SDK versions `1.24.2-beta.1` and later also support noise suppression.
 
-The calling effects library can't be used standalone. It works only when used with the Azure Communication Services Calling client library for WebJS.
+> [!IMPORTANT]
+> **Echo Cancelation** features are available in public preview SDK version [1.37.1](https://github.com/Azure/Communication/blob/master/releasenotes/acs-javascript-calling-library-release-notes.md#1371-beta1-2025-06-16). Also do note that to use echo effects you must use latest public preview audio effects SDK version beta version [1.21.1-beta](https://www.npmjs.com/package/@azure/communication-calling-effects/v/1.2.1-beta.1) or later.
 
-Use the `npm install` command to install the Azure Communication Services Audio Effects SDK for JavaScript.
+> [!NOTE]
+> - Current browser support for adding audio noise suppression effects is available only on Chrome and Edge desktop browsers.
+> - The Calling audio effects library is not a standalone module and cannot function independently. To utilize its capabilities—such as noise suppression and echo removal the effects package must be integrated with the Azure Communication Services Calling client library for WebJS.
+> - If you use the GA version of the Calling SDK, you must use the [GA version](https://www.npmjs.com/package/@azure/communication-calling-effects/v/latest) of the Calling audio effects package.
 
-If you use the GA version of the Calling SDK, you must use the [GA version](https://www.npmjs.com/package/@azure/communication-calling-effects/v/latest) of the Calling Effects SDK.
+## Step 1: Install the Audio Effects Package
+Use the `npm install` command to install the Azure Communication Services Audio Effects SDK for JavaScript.
 
 ```console
 @azure/communication-calling-effects/v/latest
 ```
 
-If you use the public preview of the Calling SDK, you must use the [beta version](https://www.npmjs.com/package/@azure/communication-calling-effects/v/next) of the Calling Effects SDK.
+If you use the **public preview** of the Calling SDK, you must use the [beta version](https://www.npmjs.com/package/@azure/communication-calling-effects/v/next) of the Calling Effects SDK.
 
 ```console
 @azure/communication-calling-effects/v/next
 ```
 
-## Load the noise suppression effects library
-
+## Enable Audio Effects 
 For information on the interface that details audio effects properties and methods, see the [Audio Effects Feature interface](/javascript/api/azure-communication-services/@azure/communication-calling/audioeffectsfeature?view=azure-communication-services-js&preserve-view=true) API documentation page.
 
+### Initialize the Audio Effects Feature
 To use noise suppression audio effects within the Azure Communication Services Calling SDK, you need the `LocalAudioStream` property that's currently in the call. You need access to the `AudioEffects` API of the `LocalAudioStream` property to start and stop audio effects.
 
 ```js
+import { createAzureCommunicationCallingWithAudioEffects } from '@azure/communication-calling-effects';
+
+const callClient = createAzureCommunicationCallingWithAudioEffects();
+```
+This wraps the standard CallClient with audio effects capabilities.
+
+### Enable Noise Suppression
+```js
+const deviceManager = await callClient.getDeviceManager();
+await deviceManager.askDevicePermission({ audio: true });
+
+const selectedMicrophone = (await deviceManager.getMicrophones())[0];
+
+const audioEffects = await deviceManager.createAudioEffects(selectedMicrophone);
+
+// Enable noise suppression
+await audioEffects.setFeature({ featureName: 'noiseSuppression', enabled: true });
+```
+### Enable Echo Cancellation
+
+=========================================
+
 import * as AzureCommunicationCallingSDK from '@azure/communication-calling'; 
 import { DeepNoiseSuppressionEffect } from '@azure/communication-calling-effects'; 
 
@@ -69,42 +109,11 @@ audioEffectsFeatureApi.on('effectsError', (error: AudioEffectErrorPayload) => {
     console.log(`Error with audio effects: ${error.message}`);
 });
 ```
-
-## Check what audio effects are active
-
-To check what noise suppression effects are currently active, you can use the `activeEffects` property.
-
-The `activeEffects` property returns an object with the names of the current active effects.
-
-```js
-// Use the audio effects feature API.
-const currentActiveEffects = audioEffectsFeatureApi.activeEffects;
-
-// Create the noise suppression instance.
-const deepNoiseSuppression = new DeepNoiseSuppressionEffect();
-// We recommend that you check support for the effect in the current environment by using the isSupported API 
-// method. Remember that noise suppression is only supported on desktop browsers for Chrome and Edge.
-
-const isDeepNoiseSuppressionSupported = await audioEffectsFeatureApi.isSupported(deepNoiseSuppression);
-if (isDeepNoiseSuppressionSupported) {
-    console.log('Noise suppression is supported in local browser environment');
-}
-
-// To start Communication Services Deep Noise Suppression
-await audioEffectsFeatureApi.startEffects({
-    noiseSuppression: deepNoiseSuppression
-});
-
-// To stop Communication Services Deep Noise Suppression
-await audioEffectsFeatureApi.stopEffects({
-    noiseSuppression: true
-});
-
-```
+=====================================
 
 ## Start a call with noise suppression automatically enabled
 
-You can start a call with noise suppression turned on. Create a new `LocalAudioStream` property with `AudioDeviceInfo` (the `LocalAudioStream` source *shouldn't* be a raw `MediaStream` property to use audio effects), and pass it in `CallStartOptions.audioOptions`:
+To initiate a call with noise suppression enabled, create a new `LocalAudioStream` property using `AudioDeviceInfo`. Ensure that the `LocalAudioStream` source is not set as a raw `MediaStream` property to support audio effects. Then, include this property within `CallStartOptions.audioOptions` when starting the call.
 
 ```js
 // As an example, here we're simply creating LocalAudioStream by using the current selected mic on DeviceManager.
@@ -157,6 +166,60 @@ await audioEffectsFeatureApi.stopEffects({
     noiseSuppression: true
 });
 ```
+## To start or stop audio effects packages during a call
+To start Azure Communication Services Deep Noise Suppression
+```js
+await audioEffectsFeatureApi.startEffects({
+    noiseSuppression: deepNoiseSuppression
+});
+```
+
+To stop Azure Communication Services Deep Noise Suppression
+```js
+await audioEffectsFeatureApi.stopEffects({
+    noiseSuppression: true
+});
+```
+
+To start Azure Communication Services echo cancelation
+```js
+await audioEffectsFeatureApi.startEffects({
+    noiseSuppression: echoCancellation
+});
+```
+
+To stop Azure Communication Services echo cancelation
+```js
+await audioEffectsFeatureApi.stopEffects({
+    echoCancellation: true
+});
+```
+
+## Check what audio effects are active
+To check what noise suppression effects are currently active, you can use the `activeEffects` property. The `activeEffects` property returns an object with the names of the current active effects.
+
+```js
+// Use the audio effects feature API.
+const currentActiveEffects = audioEffectsFeatureApi.activeEffects;
+
+// Create the noise suppression instance.
+const deepNoiseSuppression = new DeepNoiseSuppressionEffect();
+// We recommend that you check support for the effect in the current environment by using the isSupported API 
+// method. Remember that noise suppression is only supported on desktop browsers for Chrome and Edge.
+
+const isDeepNoiseSuppressionSupported = await audioEffectsFeatureApi.isSupported(deepNoiseSuppression);
+if (isDeepNoiseSuppressionSupported) {
+    console.log('Noise suppression is supported in local browser environment');
+}
+```
+
+## Best Practices
+The ACS audio effects package provides tools for reducing unwanted sounds. Additional measures can be taken to improve audio quality, such as:
+- Encouraging end users to consider using headphones to minimize the need for echo cancellation.
+- Enabling noise suppression tin shared or open work environments.
+- Setting noise suppression as the default option (i.e., having audio effects activated when a user initiates a call). If this feature is enabled automatically at the start of calls, users do not have to activate it manually. Enabling noise suppression and echo cancellation by default may help mitigate audio issues during calls.
+- Test audio effects in different environments to optimize user experience.
+
 
 ## Related content
 
