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

# PartyLocalDevice::CreateChatControl

> 지정된 사용자에 대해 로컬 채팅 컨트롤을 만드는 비동기 작업을 큐에 넣습니다.

지정된 사용자에 대해 로컬 채팅 컨트롤을 만드는 비동기 작업을 큐에 넣습니다.

## Syntax

```cpp theme={null}
PartyError CreateChatControl(  
    const PartyLocalUser* localUser,  
    PartyString languageCode,  
    void* asyncIdentifier,  
    PartyLocalChatControl** localChatControl  
)  
```

### Parameters

**`localUser`**   [PartyLocalUser\*](/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser)

새 로컬 채팅 컨트롤에 대한 로컬 사용자입니다.

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

사용할 선택적 언어입니다.

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

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

**`localChatControl`**   [PartyLocalChatControl\*\*](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
*선택 사항, 라이브러리에서 할당된 출력*

선택적 출력 로컬 채팅 컨트롤입니다.

### Return value

PartyError

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

## Remarks

이 메서드가 성공을 반환하면 비동기 작업의 결과를 제공하기 위해 [PartyCreateChatControlCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange)가 생성됩니다. 비동기 작업이 성공하면 [PartyChatControlCreatedStateChange](/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange)가 생성됩니다. 작업이 실패하면 [PartyChatControlDestroyedStateChange](/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange)가 생성됩니다. 이 메서드 자체는 채팅 컨트롤을 원격 디바이스에 표시하지 않습니다. 이 채팅 컨트롤을 원격 디바이스에 알리려면 타이틀이 [PartyNetwork::ConnectChatControl()](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_connectchatcontrol)을 호출해야 합니다. <br /><br /> 성공적으로 반환되면 이 메서드는 [PartyManager::GetChatControls()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols) 또는 로컬 디바이스에 대한 [PartyDevice::GetChatControls()](/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols)에서 이전에 반환된 배열의 메모리를 무효화합니다. 새 채팅 컨트롤을 배열에 동기적으로 추가하기 때문입니다. [PartyManager::StartProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges)도 이러한 배열의 메모리를 무효화합니다. 반환된 `localChatControl` 객체는 PartyChatControlDestroyedStateChange가 생성되고 해당 객체를 참조하는 모든 상태 변경이 [PartyManager::FinishProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges)에 반환될 때까지 유효합니다.   <br /><br /> 이 채팅 컨트롤과 연결된 언어는 선택적으로 `languageCode` 매개 변수를 통해 지정할 수 있습니다. 언어를 지정하지 않으면 플랫폼에 의해 결정된 사용자의 기본값이 사용됩니다. 언어는 전사에 대한 이 채팅 컨트롤과 연결된 사용 언어 및 들어오는 번역의 대상 언어로 사용됩니다. 예를 들어 지정된 언어 코드가 en-US인 경우, 이 채팅 컨트롤에 대한 입력 오디오는 영어(미국) 언어로 처리되고 그렇게 전사됩니다. [PartyLocalChatControl::SetTranscriptionOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions) 또는 [PartyLocalChatControl::SetTextChatOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions)를 통해 번역이 활성화되면 들어오는 음성 채팅 전사 및/또는 텍스트 채팅이 영어(미국)로 번역됩니다.   <br /><br /> 언어 코드는 BCP 47 형식이어야 합니다. 지원되는 언어 코드는 [Language support](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support)에 열거되어 있습니다. 지원되지 않거나 잘못된 언어 코드를 지정해도 이 메서드는 실패하지 않지만, 이 채팅 컨트롤과 연결된 전사 생성에 실패하게 됩니다. 이 메서드에 사용된 언어 코드는 [PartyLocalChatControl::GetLanguage()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage)를 통해 쿼리할 수 있습니다.

## Requirements

**Header:** Party.h

## See also

[PartyLocalDevice](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/partylocaldevice)\
[PartyCreateChatControlCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange)\
[PartyChatControlCreatedStateChange](/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange)\
[PartyChatControlDestroyedStateChange](/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange)\
[PartyManager::GetChatControls](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols)\
[PartyDevice::GetChatControls](/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols)\
[PartyNetwork::ConnectChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_connectchatcontrol)\
[PartyLocalChatControl::GetLanguage](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage)\
[PartyLocalChatControl::SetTranscriptionOptions](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions)\
[PartyLocalChatControl::SetTranscriptionOptions](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions)


## Related topics

- [PartyDevice::GetChatControls](/ko/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols.md)
- [PartyManager::GetChatControls](/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md)
- [PartyCreateChatControlCompletedStateChange](/ko/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange.md)
- [PartyLocalChatControl::GetLanguage](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md)
- [PartyChatControlCreatedStateChange](/ko/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange.md)