Skip to content

Commit 74e7f74

Browse files
committed
edit pass: add-noise-suppression
1 parent 6003cb0 commit 74e7f74

File tree

1 file changed

+12
-12
lines changed
  • articles/communication-services/tutorials/audio-quality-enhancements/includes

1 file changed

+12
-12
lines changed

articles/communication-services/tutorials/audio-quality-enhancements/includes/web.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The Azure Communication Services audio effects *noise suppression* abilities can
1717
## Use audio effects: Install the calling effects npm package
1818

1919
> [!IMPORTANT]
20-
> 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.1` or newer. The general availability (GA) stable version `1.28.4` and above 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 higher also support noise suppression.
20+
> 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.1` 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.
2121
>
2222
> Current browser support for adding audio noise suppression effects is available only on Chrome and Edge desktop browsers.
2323
@@ -47,7 +47,7 @@ To use noise suppression audio effects within the Azure Communication Services C
4747
import * as AzureCommunicationCallingSDK from '@azure/communication-calling';
4848
import { DeepNoiseSuppressionEffect } from '@azure/communication-calling-effects';
4949

50-
// Get the LocalAudioStream from the localAudioStream collection on the call object.
50+
// Get LocalAudioStream from the localAudioStream collection on the call object.
5151
// 'call' here represents the call object.
5252
const localAudioStreamInCall = call.localAudioStreams[0];
5353

@@ -77,10 +77,10 @@ To check what noise suppression effects are currently active, you can use the `a
7777
The `activeEffects` property returns an object with the names of the current active effects.
7878

7979
```js
80-
// Using the audio effects feature api
80+
// Use the audio effects feature API.
8181
const currentActiveEffects = audioEffectsFeatureApi.activeEffects;
8282

83-
// Create the noise suppression instance
83+
// Create the noise suppression instance.
8484
const deepNoiseSuppression = new DeepNoiseSuppressionEffect();
8585
// We recommend that you check support for the effect in the current environment by using the isSupported API
8686
// method. Remember that noise supression is only supported on desktop browsers for Chrome and Edge.
@@ -90,12 +90,12 @@ if (isDeepNoiseSuppressionSupported) {
9090
console.log('Noise supression is supported in local browser environment');
9191
}
9292

93-
// To start ACS Deep Noise Suppression
93+
// To start Communication Services Deep Noise Suppression
9494
await audioEffectsFeatureApi.startEffects({
9595
noiseSuppression: deepNoiseSuppression
9696
});
9797

98-
// To stop ACS Deep Noise Suppression
98+
// To stop Communication Services Deep Noise Suppression
9999
await audioEffectsFeatureApi.stopEffects({
100100
noiseSuppression: true
101101
});
@@ -104,10 +104,10 @@ await audioEffectsFeatureApi.stopEffects({
104104

105105
## Start a call with noise suppression automatically enabled
106106

107-
You can start a call with noise suppression turned on. Create a new `LocalAudioStream` with `AudioDeviceInfo` (the `LocalAudioStream` source *shouldn't* be a raw `MediaStream` to use audio effects), and pass it in the `CallStartOptions.audioOptions`:
107+
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`:
108108

109109
```js
110-
// As an example, here we're simply creating a LocalAudioStream by using the current selected mic on the DeviceManager
110+
// As an example, here we're simply creating LocalAudioStream by using the current selected mic on DeviceManager.
111111
const audioDevice = deviceManager.selectedMicrophone;
112112
const localAudioStreamWithEffects = new AzureCommunicationCallingSDK.LocalAudioStream(audioDevice);
113113
const audioEffectsFeatureApi = localAudioStreamWithEffects.feature(AzureCommunicationCallingSDK.Features.AudioEffects);
@@ -117,7 +117,7 @@ await audioEffectsFeatureApi.startEffects({
117117
noiseSuppression: deepNoiseSuppression
118118
});
119119

120-
// Pass the LocalAudioStream in audioOptions in call start/accept options.
120+
// Pass LocalAudioStream in audioOptions in call start/accept options.
121121
await call.startCall({
122122
audioOptions: {
123123
muted: false,
@@ -134,7 +134,7 @@ You might start a call and not have noise suppression turned on. The environment
134134
// Create the noise supression instance
135135
const deepNoiseSuppression = new DeepNoiseSuppressionEffect();
136136

137-
// Get the LocalAudioStream from the localAudioStream collection on the call object
137+
// Get LocalAudioStream from the localAudioStream collection on the call object
138138
// 'call' here represents the call object.
139139
const localAudioStreamInCall = call.localAudioStreams[0];
140140

@@ -147,12 +147,12 @@ if (isDeepNoiseSuppressionSupported) {
147147
console.log('Noise supression is supported in the current browser environment');
148148
}
149149

150-
// To start ACS Deep Noise Suppression
150+
// To start Communication Services Deep Noise Suppression
151151
await audioEffectsFeatureApi.startEffects({
152152
noiseSuppression: deepNoiseSuppression
153153
});
154154

155-
// To stop ACS Deep Noise Suppression
155+
// To stop Communication Services Deep Noise Suppression
156156
await audioEffectsFeatureApi.stopEffects({
157157
noiseSuppression: true
158158
});

0 commit comments

Comments
 (0)