你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

为音频通话体验添加音频质量增强功能

项目
05/07/2024

Azure 通信服务音频效果降噪功能可通过筛选掉不需要的背景噪音来提高音频通话质量。降噪是一种从音频通话中去除背景噪音的技术。它通过消除背景噪音，使通话更清晰、效果更好，更容易说话和倾听。降噪还可减少可以减少嘈杂场所带来的分心和疲劳。例如，如果你要在噪音很大的咖啡厅进行 Azure 通信服务 WebJS 通话，打开降噪功能可提升通话体验。

重要

本文中所述的功能目前以公共预览版提供。此预览版在提供时没有附带服务级别协议，我们不建议将其用于生产工作负荷。某些功能可能不受支持或者受限。有关详细信息，请参阅 Microsoft Azure 预览版补充使用条款。

使用音频效果 - 降噪

安装 npm 包

使用 npm install 命令安装适用于 JavaScript 的 Azure 通信服务音频效果 SDK。

重要

本教程使用 Azure 通信服务通话 SDK 版本 1.24.1-beta.1（或更高版本）和 Azure 通信服务通话音频效果 SDK 1.1.0-beta.1（或更高版本）。

npm install @azure/communication-calling-effects --save

注意

调用效果库不能单独使用，只能与用于 WebJS (https://www.npmjs.com/package/@azure/communication-calling) 的 Azure 通信通话客户端库一起使用。

可在通话通信效果 npm 包页面上找到更多详细信息。

注意

当前浏览器对添加音频降噪效果的支持仅适用于 Chrome 和 Microsoft Edge 桌面浏览器。

可了解通话 API 的具体细节。

若要在 Azure 通信通话 SDK 中使用 noise suppression 音频效果，需要通话中当前具有的 LocalAudioStream。要启动和停止音频效果，需要访问 LocalAudioStream 的 AudioEffects API。

import * as AzureCommunicationCallingSDK from '@azure/communication-calling'; 
import { DeepNoiseSuppressionEffect } from '@azure/communication-calling-effects'; 

// Get the LocalAudioStream from the localAudioStream collection on the call object
// 'call' here represents the call object.
const localAudioStreamInCall = call.localAudioStreams[0];

// Get the audio effects feature API from LocalAudioStream
const audioEffectsFeatureApi = localAudioStreamInCall.feature(SDK.Features.AudioEffects);

// Subscribe to useful events that show audio effects status
audioEffectsFeatureApi.on('effectsStarted', (activeEffects: ActiveAudioEffects) => {
    console.log(`Current status audio effects: ${activeEffects}`);
});


audioEffectsFeatureApi.on('effectsStopped', (activeEffects: ActiveAudioEffects) => {
    console.log(`Current status audio effects: ${activeEffects}`);
});


audioEffectsFeatureApi.on('effectsError', (error: AudioEffectErrorPayload) => {
    console.log(`Error with audio effects: ${error.message}`);
});

在任何时候，如果你想要检查哪些降噪效果目前处于活动状态，你可以使用 activeEffects 属性。 activeEffects 属性返回具有当前活动效果名称的对象。

// Using the audio effects feature api
const currentActiveEffects = audioEffectsFeatureApi.activeEffects;

在启用了降噪的情况下开始通话

若要在降噪打开的情况下开始通话，可以使用 AudioDeviceInfo 创建一个新的 LocalAudioStream（要使用音频效果，LocalAudioStream 源不应是原始 MediaStream），并将其传入 CallStartOptions.audioOptions：

// As an example, here we are simply creating a LocalAudioStream using the current selected mic on the DeviceManager
const audioDevice = deviceManager.selectedMicrophone;
const localAudioStreamWithEffects = new SDK.LocalAudioStream(audioDevice);
const audioEffectsFeatureApi = localAudioStreamWithEffects.feature(SDK.Features.AudioEffects);

// Start effect
await audioEffectsFeatureApi.startEffects({
    noiseSuppression: deepNoiseSuppression
});

// Pass the LocalAudioStream in audioOptions in call start/accept options.
await call.startCall({
    audioOptions: {
        muted: false,
        localAudioStreams: [localAudioStreamWithEffects]
    }
});

如何在通话进行期间启用降噪

在一些情况下，用户可能开始通话而没有启用降噪，但他们当前所处环境可能会变得嘈杂，导致他们需要启用降噪。若要启用降噪，可以使用 audioEffectsFeatureApi.startEffects API。

// Create the noise supression instance 
const deepNoiseSuppression = new DeepNoiseSuppressionEffect();

// 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
const isDeepNoiseSuppressionSupported = await audioEffectsFeatureApi.isSupported(deepNoiseSuppression);
if (isDeepNoiseSuppressionSupported) {
    console.log('Noise supression is supported in browser environment');
}

// To start ACS Deep Noise Suppression,
await audioEffectsFeatureApi.startEffects({
    noiseSuppression: deepNoiseSuppression
});

// To stop ACS Deep Noise Suppression
await audioEffectsFeatureApi.stopEffects({
    noiseSuppression: true
});

了解如何使用通话本机 SDK 配置音频筛选器。

Azure 通信服务音频效果提供可改善音频呼叫的筛选器。对于本机平台（Android、iOS 和 Windows），可以配置以下筛选器：

回声消除

它消除了从呼叫者的扬声器发出后回显到麦克风造成的声学回声，从而确保清晰的通信。

你可以在通话前或通话期间配置过滤器。仅当启用了音乐模式时，才能切换回声消除。默认情况，此筛选器处于“已启用”状态。

噪声抑制

提高音频质量，筛选掉不需要的背景噪音，如键盘声、空调声或街道噪声。这项技术可确保语音清晰明朗，促进更有效的沟通。

你可以在通话前或通话期间配置过滤器。当前可用的模式为 Off、Auto、Low 和 High。默认情况下，此功能设置为 High 模式。

自动增益控制 (AGC)

自动调整麦克风音量，以确保整个通话中的音频级别保持一致。

模拟自动增益控制是一个仅在通话前可用的筛选器。默认情况，此筛选器处于“已启用”状态。
模拟自动增益控制是一个仅在通话前可用的筛选器。默认情况，此筛选器处于“已启用”状态。

音乐模式

音乐模式是在通话前和通话期间可用的筛选器。在此处详细了解音乐模式。音乐模式仅适用于超过 1n1 的本机平台或组呼叫，不适用于本机和 Web 之间的 1：1 通话。默认情况下会禁用音乐模式。

先决条件

具有活动订阅的 Azure 帐户。免费创建帐户
已部署的通信服务资源。创建通信服务资源
用于启用通话客户端的用户访问令牌。有关详细信息，请参阅创建和管理访问令牌。
可选：完成快速入门向应用程序添加语音呼叫

安装 SDK

找到项目级别的 build.gradle 文件，并将 mavenCentral() 添加到 buildscript 和 allprojects 下的存储库列表中：

buildscript {
    repositories {
    ...
        mavenCentral()
    ...
    }
}

allprojects {
    repositories {
    ...
        mavenCentral()
    ...
    }
}

然后，在模块级别的 build.gradle 文件中，将以下行添加到 dependencies 部分：

dependencies {
    ...
    implementation 'com.azure.android:azure-communication-calling:1.0.0'
    ...
}

初始化所需的对象

若要创建 CallAgent 实例，必须对 CallClient 实例调用 createCallAgent 方法。此调用将异步返回 CallAgent 实例对象。

createCallAgent 方法采用 CommunicationUserCredential 作为参数来封装访问令牌。

若要访问 DeviceManager，必须先创建 callAgent 实例。然后，可以使用 CallClient.getDeviceManager 方法获取 DeviceManager。

String userToken = '<user token>';
CallClient callClient = new CallClient();
CommunicationTokenCredential tokenCredential = new CommunicationTokenCredential(userToken);
android.content.Context appContext = this.getApplicationContext(); // From within an activity, for instance
CallAgent callAgent = callClient.createCallAgent(appContext, tokenCredential).get();
DeviceManager deviceManager = callClient.getDeviceManager(appContext).get();

若要为主叫方设置显示名称，请使用以下替代方法：

String userToken = '<user token>';
CallClient callClient = new CallClient();
CommunicationTokenCredential tokenCredential = new CommunicationTokenCredential(userToken);
android.content.Context appContext = this.getApplicationContext(); // From within an activity, for instance
CallAgentOptions callAgentOptions = new CallAgentOptions();
callAgentOptions.setDisplayName("Alice Bob");
DeviceManager deviceManager = callClient.getDeviceManager(appContext).get();
CallAgent callAgent = callClient.createCallAgent(appContext, tokenCredential, callAgentOptions).get();

音频筛选器功能允许将不同的音频预处理选项应用于传出音频。有两种类型的音频筛选器：OutgoingAudioFilters 和 LiveOutgoingAudioFilters。其中，OutgoingAudioFilters 在通话开始前更改设置，LiveOutgoingAudioFilters 在通话进行时更改设置。

你首先需要导入通话 SDK 和关联的类：

import com.azure.android.communication.calling.OutgoingAudioOptions;
import com.azure.android.communication.calling.OutgoingAudioFilters;
import com.azure.android.communication.calling.LiveOutgoingAudioFilters;

通话开始前

OutgoingAudioFilters 可以在通话开始时应用。

首先创建一个 OutgoingAudioFilters 并将其传递给 OutgoingAudioOptions，如以下代码所示：

OutgoingAudioOptions outgoingAudioOptions = new OutgoingAudioOptions();
OutgoingAudioFilters filters = new OutgoingAudioFilters();
filters.setNoiseSuppressionMode(NoiseSuppressionMode.HIGH);
filters.setAnalogAutomaticGainControlEnabled(true);
filters.setDigitalAutomaticGainControlEnabled(true);
filters.setMusicModeEnabled(true);
filters.setAcousticEchoCancellationEnabled(true); 
outgoingAudioOptions.setAudioFilters(filters);

通话过程中

LiveOutgoingAudioFilters 可以在通话开始后应用。在通话开始后，你可以从通话对象中检索此对象。若要更改 LiveOutgoingAudioFilters 中的设置，请将类中的成员设置为有效值，然后便会应用它们。

在通话进行期间，OutgoingAudioFilters 提供的筛选器只有一部分可用：音乐模式、回声消除和噪声抑制模式。

LiveOutgoingAudioFilters filters = call.getLiveOutgoingAudioFilters();
filters.setMusicModeEnabled(false);
filters.setAcousticEchoCancellationEnabled(false);
filters.setNoiseSuppressionMode(NoiseSuppressionMode.HIGH);

了解如何使用通话本机 SDK 配置音频筛选器。

Azure 通信服务音频效果提供可改善音频呼叫的筛选器。对于本机平台（Android、iOS 和 Windows），可以配置以下筛选器：

回声消除

它消除了从呼叫者的扬声器发出后回显到麦克风造成的声学回声，从而确保清晰的通信。

你可以在通话前或通话期间配置过滤器。仅当启用了音乐模式时，才能切换回声消除。默认情况，此筛选器处于“已启用”状态。

噪声抑制

提高音频质量，筛选掉不需要的背景噪音，如键盘声、空调声或街道噪声。这项技术可确保语音清晰明朗，促进更有效的沟通。

你可以在通话前或通话期间配置过滤器。当前可用的模式为 Off、Auto、Low 和 High。默认情况下，此功能设置为 High 模式。

自动增益控制 (AGC)

自动调整麦克风音量，以确保整个通话中的音频级别保持一致。

模拟自动增益控制是一个仅在通话前可用的筛选器。默认情况，此筛选器处于“已启用”状态。
模拟自动增益控制是一个仅在通话前可用的筛选器。默认情况，此筛选器处于“已启用”状态。

音乐模式

先决条件

具有活动订阅的 Azure 帐户。免费创建帐户
已部署的通信服务资源。创建通信服务资源
用于启用通话客户端的用户访问令牌。有关详细信息，请参阅创建和管理访问令牌。
可选：完成快速入门向应用程序添加语音呼叫

设置系统

创建 Xcode 项目

在 Xcode 中，创建新的 iOS 项目，并选择“单视图应用”模板。本快速入门使用 SwiftUI 框架，因此应将“语言”设置为“Swift”，并将“接口”设置为“SwiftUI”。

在此快速入门过程中，无需创建测试。请随意清除“包括测试”复选框。

显示用于在 Xcode 中创建项目的窗口的屏幕截图。

使用 CocoaPods 安装包和依赖项

为应用程序创建 Podfile，如此示例所示：

platform :ios, '13.0'
use_frameworks!
target 'AzureCommunicationCallingSample' do
    pod 'AzureCommunicationCalling', '~> 1.0.0'
end

运行 pod install。
使用 Xcode 打开 .xcworkspace。

请求访问麦克风

若要访问设备的麦克风，需要使用 NSMicrophoneUsageDescription 更新应用的信息属性列表。将关联的值设置为将要包含在系统用于向用户请求访问权限的对话框中的字符串。

右键单击项目树的 Info.plist 条目，然后选择“打开为...”>“源代码”。将以下代码行添加到顶层 <dict> 节，然后保存文件。

<key>NSMicrophoneUsageDescription</key>
<string>Need microphone access for VOIP calling.</string>

设置应用框架

打开项目的 ContentView.swift 文件。将 import 声明添加到文件顶部以导入 AzureCommunicationCalling 库。此外，导入 AVFoundation。你将需要用它来处理代码中的音频权限请求。

import AzureCommunicationCalling
import AVFoundation

初始化 CallAgent

若要从 CallClient 创建 CallAgent 实例，必须使用 callClient.createCallAgent 方法，该方法在初始化后异步返回 CallAgent 对象。

若要创建通话客户端，请传递 CommunicationTokenCredential 对象：

import AzureCommunication

let tokenString = "token_string"
var userCredential: CommunicationTokenCredential?
do {
    let options = CommunicationTokenRefreshOptions(initialToken: token, refreshProactively: true, tokenRefresher: self.fetchTokenSync)
    userCredential = try CommunicationTokenCredential(withOptions: options)
} catch {
    updates("Couldn't created Credential object", false)
    initializationDispatchGroup!.leave()
    return
}

// tokenProvider needs to be implemented by Contoso, which fetches a new token
public func fetchTokenSync(then onCompletion: TokenRefreshOnCompletion) {
    let newToken = self.tokenProvider!.fetchNewToken()
    onCompletion(newToken, nil)
}

将创建的 CommunicationTokenCredential 对象传递给 CallClient 并设置显示名称：

self.callClient = CallClient()
let callAgentOptions = CallAgentOptions()
options.displayName = " iOS Azure Communication Services User"

self.callClient!.createCallAgent(userCredential: userCredential!,
    options: callAgentOptions) { (callAgent, error) in
        if error == nil {
            print("Create agent succeeded")
            self.callAgent = callAgent
        } else {
            print("Create agent failed")
        }
})

你首先需要导入通话 SDK：

import AzureCommunicationCalling

通话开始前

OutgoingAudioFilters 可以在通话开始时应用。

首先创建一个 OutgoingAudioFilters 并将其传递给 OutgoingAudioOptions，如以下代码所示：

let outgoingAudioOptions = OutgoingAudioOptions()
let filters = OutgoingAudioFilters()
filters.NoiseSuppressionMode = NoiseSuppressionMode.high
filters.analogAutomaticGainControlEnabled = true
filters.digitalAutomaticGainControlEnabled = true
filters.musicModeEnabled = true
filters.acousticEchoCancellationEnabled = true
outgoingAudioOptions.audioFilters = filters

通话过程中

在通话进行期间，OutgoingAudioFilters 提供的筛选器只有一部分可用：音乐模式、回声消除和噪声抑制模式。

LiveOutgoingAudioFilters filters = call.liveOutgoingAudioFilters
filters.musicModeEnabled = true
filters.acousticEchoCancellationEnabled = true
filters.NoiseSuppressionMode = NoiseSuppressionMode.high

了解如何使用通话本机 SDK 配置音频筛选器。

Azure 通信服务音频效果提供可改善音频呼叫的筛选器。对于本机平台（Android、iOS 和 Windows），可以配置以下筛选器：

回声消除

它消除了从呼叫者的扬声器发出后回显到麦克风造成的声学回声，从而确保清晰的通信。

你可以在通话前或通话期间配置过滤器。仅当启用了音乐模式时，才能切换回声消除。默认情况，此筛选器处于“已启用”状态。

噪声抑制

提高音频质量，筛选掉不需要的背景噪音，如键盘声、空调声或街道噪声。这项技术可确保语音清晰明朗，促进更有效的沟通。

你可以在通话前或通话期间配置过滤器。当前可用的模式为 Off、Auto、Low 和 High。默认情况下，此功能设置为 High 模式。

自动增益控制 (AGC)

自动调整麦克风音量，以确保整个通话中的音频级别保持一致。

模拟自动增益控制是一个仅在通话前可用的筛选器。默认情况，此筛选器处于“已启用”状态。
模拟自动增益控制是一个仅在通话前可用的筛选器。默认情况，此筛选器处于“已启用”状态。

音乐模式

先决条件

具有活动订阅的 Azure 帐户。免费创建帐户
已部署的通信服务资源。创建通信服务资源
用于启用通话客户端的用户访问令牌。有关详细信息，请参阅创建和管理访问令牌。
可选：完成快速入门向应用程序添加语音呼叫

设置系统

创建 Visual Studio 项目

对于 UWP 应用，请在 Visual Studio 2022 中创建新的“空白应用(通用 Windows)”项目。输入项目名称后，可随意选择任何版本高于 10.0.17763.0 的 Windows SDK。

对于 WinUI 3 应用，请使用“已打包空白应用(桌面中的 WinUI 3)”模板创建新项目，以设置单页 WinUI 3 应用。需要 Windows App SDK 版本 1.3 或更高版本。

使用 NuGet 包管理器安装包和依赖项

可通过 NuGet 包公开提供通话 SDK API 和库。

以下步骤举例说明了如何查找、下载和安装通话 SDK NuGet 包：

选择“工具”>“NuGet 包管理器”>“管理解决方案的 NuGet 包”，以打开 NuGet 包管理器。
选择“浏览”，然后在搜索框中输入 Azure.Communication.Calling.WindowsClient。
确保已选中“包括预发行版”复选框。
选择 Azure.Communication.Calling.WindowsClient 包，然后选择 Azure.Communication.Calling.WindowsClient1.4.0-beta.1 或更高版本。
在右侧选项卡上选中与 Azure 通信服务项目对应的复选框。
选择“安装”按钮。

你首先需要导入通话 SDK：

using Azure.Communication;
using Azure.Communication.Calling.WindowsClient;

通话开始前

OutgoingAudioFilters 可以在通话开始时应用。

首先创建一个 OutgoingAudioFilters 并将其传递给 OutgoingAudioOptions，如以下代码所示：

var outgoingAudioOptions = new OutgoingAudioOptions();
var filters = new OutgoingAudioFilters()
{
    AnalogAutomaticGainControlEnabled = true,
    DigitalAutomaticGainControlEnabled = true,
    MusicModeEnabled = true,
    AcousticEchoCancellationEnabled = true,
    NoiseSuppressionMode = NoiseSuppressionMode.High
};
outgoingAudioOptions.Filters = filters;

通话过程中

在通话进行期间，OutgoingAudioFilters 提供的筛选器只有一部分可用：音乐模式、回声消除和噪声抑制模式。

LiveOutgoingAudioFilters filter = call.LiveOutgoingAudioFilters;
filter.MusicModeEnabled = true;
filter.AcousticEchoCancellationEnabled = true;
filter.NoiseSuppressionMode = NoiseSuppressionMode.Auto;

为音频通话体验添加音频质量增强功能

使用音频效果 - 降噪

安装 npm 包

在启用了降噪的情况下开始通话

如何在通话进行期间启用降噪

了解如何使用通话本机 SDK 配置音频筛选器。

回声消除

噪声抑制

自动增益控制 (AGC)

音乐模式

先决条件

安装 SDK

初始化所需的对象

通话开始前

通话过程中

了解如何使用通话本机 SDK 配置音频筛选器。

回声消除

噪声抑制

自动增益控制 (AGC)

音乐模式

先决条件

设置系统

创建 Xcode 项目

使用 CocoaPods 安装包和依赖项

请求访问麦克风

设置应用框架

初始化 CallAgent

通话开始前

通话过程中

了解如何使用通话本机 SDK 配置音频筛选器。

回声消除

噪声抑制

自动增益控制 (AGC)

音乐模式

先决条件

设置系统

创建 Visual Studio 项目

使用 NuGet 包管理器安装包和依赖项

通话开始前

通话过程中

其他资源