> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 语音音频噪声抑制

> 在 PlayFab Party 语音聊天中启用动态麦克风噪声抑制，以在嘈杂环境中改善 Android 和 iOS 设备上玩家的语音质量。

# 使用噪声抑制改善语音音频质量

PlayFab Party 支持在玩家之间捕获和传输麦克风音频，以启用实时语音聊天。背景噪声通常会与麦克风音频一起被捕获，并可能降低其他玩家听到的该玩家语音的质量。为了在嘈杂环境中改善玩家语音音频的质量，你可以配置 PlayFab Party 动态抑制从玩家麦克风捕获的噪声。

## 先决条件

本演练假定你对 [PlayFab Party 中的语音聊天](/services/playfab/community/voice-communications/concepts-chat)有基本了解。

## 平台支持

并非所有平台都可以使用噪声抑制。虽然与噪声抑制相关的方法存在于统一的跨平台标头中，但它们目前仅针对 Android 和 iOS 实现。这些方法在其他平台上将返回错误。

### 设备型号限制

PlayFab Party 上的噪声抑制仅在具有高级 SIMD (Neon) 增强 CPU 的 Android 设备上受支持。可以在没有此支持的 Android 设备上启用噪声抑制，但语音音频将在没有任何噪声抑制的情况下传输。

在 iOS 上，所有 iOS 设备均支持噪声抑制。

## 如何在游戏中启用噪声抑制

### 在游戏中打包模型

PlayFab Party 上的噪声抑制需要在游戏中打包一个附加文件。找到随 Party 库包一起分发的 **PartyNoiseSuppressionModel.fpie** 文件。根据平台，需要采取不同的操作。

#### Android

将 **PartyNoiseSuppressionModel.fpie** 文件复制到 **\{game}/src/main/assets/directory** 内。

#### iOS

在游戏资源中包含 PartyNoiseSuppressionModel.fpie。

### 示例：为本地聊天控件启用噪声抑制

```cpp theme={null}
PartyError error = localChatControl->SetVoiceAudioOptions(PartyVoiceAudioOptions::NoiseSuppression);
if (PARTY_FAILED(error))
{
    printf("Failed to enable noise suppression for local chat control 0x%p! error = 0x%08x\n", localChatControl, error);
}
```

### 示例：为本地聊天控件禁用噪声抑制

```cpp theme={null}
// to disable noise suppression for a local chat control
PartyError error = localChatControl->SetVoiceAudioOptions(PartyVoiceAudioOptions::None);
if (PARTY_FAILED(error))
{
    printf("Failed to disable noise suppression for local chat control 0x%p! error = 0x%08x\n", localChatControl, error);
}
```

## 性能注意事项

根据内部测试，在 PlayFab Party 上启用噪声抑制不会显著影响 CPU 性能或电池寿命。

## 另请参阅

* [Party 概述](/services/playfab/multiplayer/networking)
* [Party 快速入门](/services/playfab/multiplayer/networking/quickstart)
* [Android 特定要求](/services/playfab/multiplayer/networking/android-specific-requirements)
* [iOS 和 macOS 特定要求](/services/playfab/multiplayer/networking/apple-specific-requirements)


## Related topics

- [了解 PlayFab Party 聊天的工作原理](/zh-CN/services/playfab/community/voice-communications/concepts-chat.md)
- [PartyVoiceAudioOptions](/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyvoiceaudiooptions.md)
- [PartyChatControl::ConfigureAudioManipulationVoiceStream](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/methods/partychatcontrol_configureaudiomanipulationvoicestream.md)
- [PartyAudioSourceType](/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyaudiosourcetype.md)
- [PartyChatControlChatIndicator](/zh-CN/services/playfab/multiplayer/networking/reference/enums/partychatcontrolchatindicator.md)