Skip to content

Commit

Permalink
add docs about noise cancellation and update settings table
Browse files Browse the repository at this point in the history
  • Loading branch information
tbarbugli committed Nov 5, 2024
1 parent c36fbd8 commit aafe089
Show file tree
Hide file tree
Showing 4 changed files with 36 additions and 1 deletion.
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
id: noise-cancellation
sidebar_position: 5
slug: /call_types/noise_cancellation
title: Noise Cancellation
---

Noise cancellation is a feature that removes background noise from a call. This feature is useful when you are in a noisy environment and want to improve the call quality.
Stream video SDKs come with built-in noise cancellation, which you can enable or disable as needed.

Note: noise cancellation is performed on the device that captures the audio and not by Stream servers.

The built-in noise cancellation is optimized for voice calls and is not suitable for capturing music or other audio. You can configure noise cancellation for your call types in three ways:

- `available` noise cancellation can be enabled by users via SDK but it starts disabled
- `disabled` noise cancellation is not available for users to enable (do this if you want to ensure noise cancellation is never used)
- `auto-on` noise cancellation is always enabled for all calls, users can still disabled it manually via SDK

### Best practices

1. Use noise cancellation to improve call quality, especially in noisy environments
2. Do not use noise cancellation if you want to capture music or other audio
3. Noise cancellation is charged per minute, if you dont need it, disable it to save costs

### Custom noise cancellation

All SDKs come with support for custom audio and video filters. If needed, you can bring your own noise cancellation filter instead of using the built-in noise cancellation. SDK docs have more information on how to do this.
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
id: call_types_settings
sidebar_position: 5
sidebar_position: 6
slug: /call_types/settings
title: Settings
---
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1000,3 +1000,7 @@ curl -X PUT "https://video.stream-io-api.com/api/v2/video/calltypes/${CALL_TYPE_
## Client-side recording

Unfortunately, there is no direct support for client-side recording at the moment. Call recording at the moment is done by Stream server-side. If client-side recording is important for you please make sure to follow the conversation [here](https://github.com/GetStream/protocol/discussions/249).

## Noise Cancellation

Enabling noise cancellation can help to improve the quality of the recorded audio. This feature is available for all calls and can be enabled from the dashboard or via the API.
Original file line number Diff line number Diff line change
Expand Up @@ -567,3 +567,7 @@ curl -X POST "https://video.stream-io-api.com/api/v2/video/call/default/${CALL_I
- Malay (ms)
- Norwegian (no)
- Ukrainian (uk)

## Noise Cancellation

Enabling noise cancellation can help to improve the quality of transcriptions and closed captions. It is recommended to enable noise cancellation when transcribing calls with background noise.

0 comments on commit aafe089

Please sign in to comment.