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
-**Device Management and Media** - The Calling SDK provides facilities for binding to audio and video devices, encodes content for efficient transmission over the communications dataplane, and renders content to output devices and views that you specify. APIs are also provided for screen and application sharing.
37
37
-**PSTN** - The Calling SDK can initiate voice calls with the traditional publicly switched telephone network, [using phone numbers you acquire in the Azure portal](../../quickstarts/telephony/get-phone-number.md) or programmatically. You can also bring your own numbers using session border controllers.
38
38
-**Teams Meetings & Calling** - The Calling SDK can [join Teams meetings](../../quickstarts/voice-video-calling/get-started-teams-interop.md) and interact with the Teams voice and video dataplane.
@@ -96,10 +96,11 @@ The following list presents the set of features that are currently available in
The **music mode** enhances the audio quality for music playback and performance within virtual environments, ensuring clarity and depth in sound reproduction; currently supports a 32-kHz sampling rate at 128 kbps when network bandwidth allows; when network bandwidth is insufficient, the bitrate can be reduced to as low as 48 kbps.
19
17
20
18
This feature is designed to elevate the audio quality for calls, ensuring the audio is crispy and offering a richer and more immersive audio experience. Also, it reduces audio compression to maintain the original sound, making it ideal for applications ranging from live musical performances and remote music education or music sessions.
@@ -30,10 +28,10 @@ We recommend using high-quality external loudspeakers, professional microphones,
30
28
31
29
The Calling native SDK provides an additional set of audio filters that bring a richer experience during the call:
32
30
33
-
- Analog Automatic gain control
34
-
- Digital Automatic gain control
35
31
- Echo cancellation. *You can only toggle echo cancellation only if music mode is enabled*
36
32
- Noise suppression. *The currently available modes are `Off`, `Auto`, `Low`, and `High`*
33
+
- Analog Automatic gain control
34
+
- Digital Automatic gain control
37
35
38
36
## Next steps
39
-
-[Learn how to setup audio filters](../../how-tos/calling-sdk/manage-audio-filters.md)
37
+
-[Learn how to setup audio filters](../../tutorials/audio-quality-enhancements/add-noise-supression.md)
# Add audio quality enhancements to your audio calling experience
15
-
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. It makes audio calls clearer and better by eliminating background noise, making 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 coffee shop with considerable noise, turning on noise suppression can make the call experience better.
Use the `npm install` command to install the Azure Communication Services Audio Effects SDK for JavaScript.
22
-
> [!IMPORTANT]
23
-
> This tutorial uses the Azure Communication Services Calling SDK version of `1.24.1-beta.1` (or greater) and the Azure Communication Services Calling Audio Effects SDK version greater than or equal to `1.1.0-beta.1` (or greater).
> The calling effect library cannot be used standalone and can only work when used with the Azure Communication Calling client library for WebJS (https://www.npmjs.com/package/@azure/communication-calling).
29
-
30
-
You can find more [details ](https://www.npmjs.com/package/@azure/communication-calling-effects) on the calling effects npm package page.
31
-
32
-
> [!NOTE]
33
-
> Current browser support for adding audio noise suppression effects is only available on Chrome and Edge Desktop Browsers.
34
-
35
-
> You can learn about the specifics of the [calling API](/javascript/api/azure-communication-services/@azure/communication-calling/?view=azure-communication-services-js&preserve-view=true).
36
-
37
-
To use `noise suppression` audio effects within the Azure Communication Calling SDK, you need the `LocalAudioStream` that is currently in the call. You need access to the `AudioEffects` API of the `LocalAudioStream` to start and stop audio effects.
To start a call with **noise suppression** turned on, you can create a new `LocalAudioStream` with a `AudioDeviceInfo` (the LocalAudioStream source <u>shouldn't</u> be a raw `MediaStream` to use audio effects), and pass it in the `CallStartOptions.audioOptions`:
74
-
```js
75
-
// As an example, here we are simply creating a LocalAudioStream using the current selected mic on the DeviceManager
// Pass the LocalAudioStream in audioOptions in call start/accept options.
86
-
awaitcall.startCall({
87
-
audioOptions: {
88
-
muted:false,
89
-
localAudioStreams: [localAudioStreamWithEffects]
90
-
}
91
-
});
92
-
```
16
+
# Add audio quality enhancements to your audio calling experience
93
17
94
-
### How to turn on Noise Suppression during an ongoing call
95
-
There are situations where a user might start a call and not have **noise suppression** turned on, but their current environment might get noisy resulting in them needing to turn on **noise suppression**. To turn on **noise suppression**, you can use the `audioEffectsFeatureApi.startEffects` API.
[!INCLUDE [Audio effects for Web](./includes/web.md)]
20
+
::: zone-end
99
21
100
-
// Its recommened to check support for the effect in the current environment using the isSupported method on the feature API. Remember that Noise Supression is only supported on Desktop Browsers for Chrome and Edge
The audio filter feature allows different audio preprocessing options to be applied to outgoing audio. There are two types of audio filters: `OutgoingAudioFilters` and `LiveOutgoingAudioFilters`, with `OutgoingAudioFilters` changing settings before the call starts and `LiveOutgoingAudioFilters` changing settings while a call is in progress.
20
+
21
+
You first need to import the Calling SDK and the associated classes:
`LiveOutgoingAudioFilters` can be applied after a call has started. You can retrieve this object from the call object once the call has started. To change the setting in `LiveOutgoingAudioFilters`, set the members inside the class to a valid value and they're applied.
49
+
50
+
Only a subset of the filters available from `OutgoingAudioFilters` are available during an active call: music mode, echo cancellation, and noise suppression mode.
0 commit comments