> ## 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.

# Voice Audio Noise Suppression

> Enable dynamic microphone noise suppression in PlayFab Party voice chat to improve player voice quality in noisy environments on Android and iOS devices.

# 노이즈 억제로 음성 오디오 품질 향상

PlayFab Party는 실시간 음성 채팅을 가능하게 하기 위해 플레이어 간의 마이크 오디오를 캡처하고 전송하는 것을 지원합니다. 배경 소음은 이 마이크 오디오와 함께 캡처되어 다른 플레이어가 듣는 해당 플레이어의 음성 품질을 저하시키는 경우가 많습니다. 시끄러운 환경에서 플레이어 음성 오디오의 품질을 향상시키려면, 플레이어 마이크에서 캡처된 소음을 동적으로 억제하도록 PlayFab Party를 구성할 수 있습니다.

## 필수 구성 요소

이 안내에서는 [PlayFab Party의 음성 채팅](/services/playfab/community/voice-communications/concepts-chat)에 대한 기본적인 이해가 있다고 가정합니다.

## 플랫폼 지원

노이즈 억제는 모든 플랫폼에서 사용할 수 있는 것은 아닙니다. 노이즈 억제와 관련된 메서드는 통합된 크로스 플랫폼 헤더에 존재하지만, 현재 Android와 iOS에만 구현되어 있습니다. 다른 플랫폼에서 이 메서드를 호출하면 오류가 반환됩니다.

### 장치 모델 제한

PlayFab Party의 노이즈 억제는 Advanced 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

- [PartyVoiceAudioOptions](/ko/services/playfab/multiplayer/networking/reference/enums/partyvoiceaudiooptions.md)
- [Troubleshooting Voice Chat](/ko/services/playfab/community/voice-communications/concepts-audio-troubleshooting.md)
- [Apply custom voice effects with real-time audio manipulation](/ko/services/playfab/community/voice-communications/concepts-realtime-audio-manipulation.md)
- [PartyConfigureAudioManipulationVoiceStreamCompletedStateChange](/ko/services/playfab/multiplayer/networking/reference/structs/partyconfigureaudiomanipulationvoicestreamcompletedstatechange.md)
- [PartyLocalChatControl::SetVoiceAudioOptions](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setvoiceaudiooptions.md)