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

# PartyLocalChatControl::SetAudioOutput

> 채팅 컨트롤이 오디오 출력에 사용할 기본 스피커 또는 헤드셋 디바이스를 구성합니다.

채팅 컨트롤이 오디오 출력에 사용할 기본 스피커 또는 헤드셋 디바이스를 구성합니다.

## Syntax

```cpp theme={null}
PartyError SetAudioOutput(  
    PartyAudioDeviceSelectionType audioDeviceSelectionType,  
    PartyString audioDeviceSelectionContext,  
    void* asyncIdentifier  
)  
```

### Parameters

**`audioDeviceSelectionType`**   [PartyAudioDeviceSelectionType](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)

[PartyAudioDeviceSelectionType::None](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)이 지정되면 오디오 출력이 지워집니다. [PartyAudioDeviceSelectionType::SystemDefault](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)가 지정되면 Party 라이브러리는 시스템의 기본 통신 디바이스를 사용하려고 시도합니다. [PartyAudioDeviceSelectionType::PlatformUserDefault](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)가 지정되면 Party 라이브러리는 `audioDeviceSelectionContext`와 연결된 기본 통신 디바이스를 사용하려고 시도합니다. [PartyAudioDeviceSelectionType::Manual](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)이 지정되면 Party 라이브러리는 디바이스 식별자가 `audioDeviceSelectionContext`와 일치하는 통신 디바이스를 사용하려고 시도합니다.

**`audioDeviceSelectionContext`**   [PartyString](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/typedefs.md)\
*선택 사항*

[PartyAudioDeviceSelectionType::None](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md) 또는 [PartyAudioDeviceSelectionType::SystemDefault](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)를 사용하는 경우 `audioDeviceSelectionContext`는 무시됩니다. [PartyAudioDeviceSelectionType::PlatformUserDefault](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)를 사용하는 경우 `audioDeviceSelectionContext`는 채팅 컨트롤이 오디오 디바이스를 선택할 때 사용해야 하는 null이 아니고 비어 있지 않은 플랫폼별 사용자 컨텍스트여야 합니다. [PartyAudioDeviceSelectionType::Manual](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)을 사용하는 경우 `audioDeviceSelectionContext`는 채팅 컨트롤이 사용해야 하는 오디오 디바이스의 null이 아니고 비어 있지 않은 식별자여야 합니다.

**`asyncIdentifier`**   void\*\
*선택 사항*

완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적, 앱 정의, 포인터 크기의 컨텍스트 값입니다.

### Return value

PartyError

오디오 출력 설정을 위한 비동기 작업이 시작된 경우 `c_partyErrorSuccess`, 그렇지 않으면 오류 코드입니다. 이 메서드가 실패하면 관련 상태 변경이 생성되지 않습니다. 오류 코드의 사람이 읽을 수 있는 형식은 [PartyManager::GetErrorMessage()](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md)를 통해 검색할 수 있습니다.

## Remarks

이 메서드는 이 로컬 채팅 컨트롤과 연결된 기본 스피커 또는 헤드셋 디바이스를 구성하기 위한 비동기 작업을 큐에 넣습니다. 메서드가 성공하면 출력 디바이스 상태에 대한 세부 정보와 함께 [PartyLocalChatAudioOutputChangedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partylocalchataudiooutputchangedstatechange.md)가 [PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md)를 통해 제공되며, 작업 완료 시 성공 또는 실패를 나타내는 [PartySetChatAudioOutputCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partysetchataudiooutputcompletedstatechange.md)가 제공됩니다. 완료 후에는 디바이스 제거 등으로 인해 오디오 디바이스 상태가 변경될 때마다 추가 [PartyLocalChatAudioOutputChangedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partylocalchataudiooutputchangedstatechange.md)가 제공됩니다. \
\
 지정된 디바이스가 없으면 채팅 컨트롤은 오디오 디바이스 변경을 구독하고 해당 디바이스가 나타나면 사용합니다.   \
\
 XBOX 플랫폼에서 `PlatformUserDefault` 옵션을 사용하는 경우 XBOX 사용자 식별자(XUID)를 `audioDeviceSelectionContext` 값으로 전달해야 합니다.

## Requirements

**Header:** Party.h

## See also

[PartyLocalChatControl](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)\
[PartyLocalChatControl::GetAudioOutput](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiooutput.md)\
[PartyLocalChatControl::SetAudioInput](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudioinput.md)


## Related topics

- [PartyLocalChatControl::GetAudioOutput](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiooutput.md)
- [PartyLocalChatControl::SetAudioInput](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudioinput.md)
- [PartyLocalChatAudioOutputChangedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partylocalchataudiooutputchangedstatechange.md)
- [PartySetChatAudioOutputCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/structs/partysetchataudiooutputcompletedstatechange.md)
- [PartyAudioDeviceSelectionType](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)