> ## 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 中的語音聊天](/zh-TW/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 概觀](/zh-TW/services/playfab/multiplayer/networking)
* [Party 快速入門](/zh-TW/services/playfab/multiplayer/networking/quickstart)
* [Android 特定需求](/zh-TW/services/playfab/multiplayer/networking/android-specific-requirements)
* [iOS 和 macOS 特定需求](/zh-TW/services/playfab/multiplayer/networking/apple-specific-requirements)


## Related topics

- [语音音频噪声抑制](/zh-CN/services/playfab/community/voice-communications/concepts-noise-suppression.md)
- [PlayFab Party 版本資訊](/zh-TW/services/playfab/multiplayer/networking/release-notes.md)
- [無障礙功能標籤](/zh-TW/build/game-principles/accessibility/accessibility-feature-tags.md)
- [了解 PlayFab Party 聊天的工作原理](/zh-CN/services/playfab/community/voice-communications/concepts-chat.md)
- [PartyVoiceAudioOptions](/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyvoiceaudiooptions.md)