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

# PartyLocalChatControl::SetAudioInput

> 채팅 컨트롤이 오디오 입력에 사용할 기본 마이크 또는 녹음 디바이스를 구성합니다.

채팅 컨트롤이 오디오 입력에 사용할 기본 마이크 또는 녹음 디바이스를 구성합니다.

## Syntax

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

### Parameters

**`audioDeviceSelectionType`**   [PartyAudioDeviceSelectionType](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype)

[PartyAudioDeviceSelectionType::None](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype)이 지정되면 오디오 입력이 지워집니다. [PartyAudioDeviceSelectionType::SystemDefault](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype)가 지정되면 Party 라이브러리는 시스템의 기본 통신 디바이스를 사용하려고 시도합니다. [PartyAudioDeviceSelectionType::PlatformUserDefault](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype)가 지정되면 Party 라이브러리는 `audioDeviceSelectionContext`와 연결된 기본 통신 디바이스를 사용하려고 시도합니다. [PartyAudioDeviceSelectionType::Manual](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype)이 지정되면 Party 라이브러리는 디바이스 식별자가 일치하는 통신 디바이스를 사용하려고 시도합니다. `PartyAudioDeviceSelectionType::Manual`은 Android, iOS 또는 macOS에서 지원되지 않는다는 점에 유의하세요.

**`audioDeviceSelectionContext`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)\
*선택 사항*

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

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

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

### Return value

PartyError

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

## Remarks

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

## Requirements

**Header:** Party.h

## See also

[PartyLocalChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
[PartyLocalChatControl::GetAudioInput](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudioinput)\
[PartyLocalChatControl::SetAudioOutput](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiooutput)


## Related topics

- [PartyLocalChatControl::GetAudioInput](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudioinput.md)
- [PartyLocalChatControl::SetAudioOutput](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiooutput.md)
- [PartyLocalChatAudioInputChangedStateChange](/ko/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange.md)
- [PartySetChatAudioInputCompletedStateChange](/ko/services/playfab/multiplayer/networking/reference/structs/partysetchataudioinputcompletedstatechange.md)
- [PartyAudioDeviceSelectionType](/ko/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)