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

# PartyChatTextReceivedStateChange

> 상태 변경의 *ChatTextReceived* 유형에 특정한 정보입니다.

상태 변경의 *ChatTextReceived* 유형에 특정한 정보입니다.

## Syntax

```cpp theme={null}
struct PartyChatTextReceivedStateChange : PartyStateChange {  
    PartyChatControl* senderChatControl;  
    uint32_t receiverChatControlCount;  
    PartyLocalChatControlArray receiverChatControls;  
    PartyString languageCode;  
    PartyString chatText;  
    uint32_t dataSize;  
    const void* data;  
    uint32_t translationCount;  
    PartyTranslation* translations;  
    PartyChatTextReceivedOptions options;  
    PartyString originalChatText;  
    PartyError errorDetail;  
}  
```

### Members

**`senderChatControl`**   [PartyChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/partychatcontrol)\*

텍스트 메시지를 시작한 채팅 컨트롤 개체입니다.

**`receiverChatControlCount`**   uint32\_t

텍스트 메시지가 전송되는 로컬 수신자 채팅 컨트롤의 수입니다.

**`receiverChatControls`**   [PartyLocalChatControlArray](/services/playfab/multiplayer/networking/reference/typedefs)\
*크기 `receiverChatControlCount`의 배열*

텍스트 메시지가 전송되는 로컬 수신자 채팅 컨트롤입니다.

**`languageCode`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

채팅 텍스트의 언어입니다.

언어는 로컬 언어로의 번역이 활성화된 경우에만 제공됩니다. 번역이 활성화되지 않았거나 번역 중에 실패가 발생한 경우, 언어 코드는 빈 문자열입니다. <br /><br /> 언어 코드는 영어(미국)를 나타내는 en-US와 같은 BCP 47 형식입니다. 지원되는 언어 코드는 [Language support](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support)에 열거되어 있습니다.

**`chatText`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

수신된 채팅 텍스트입니다.

문자열은 null 종결자를 포함하지 않고 최대 `c_maxChatTextMessageLength`자까지 지정할 수 있습니다. <br /><br /> 필터링이 활성화되어 있는 경우, 이 텍스트는 원격 사용자가 보낸 정확한 텍스트가 아닐 수 있습니다. 정확한 원본 텍스트는 `originalChatText` 필드에서 검색할 수 있습니다.

**`dataSize`**   uint32\_t

이 텍스트 메시지와 연결된 데이터의 크기입니다.

**`data`**   const void\*\
*크기 `dataSize` 바이트의 버퍼*

이 텍스트 메시지와 연결된 데이터입니다.

**`translationCount`**   uint32\_t

채팅 텍스트와 연결된 번역의 수입니다.

번역은 [PartyTextChatOptions::TranslateToLocalLanguage](/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions)가 이전에 이 디바이스에 로컬인 채팅 컨트롤에서 [PartyLocalChatControl::SetTextChatOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions)를 통해 지정된 경우 제공됩니다. 여러 로컬 채팅 컨트롤에서 번역을 활성화했고 로컬 채팅 컨트롤이 [PartyLocalDevice::CreateChatControl()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol)을 통해 서로 다른 언어를 지정한 경우 번역이 두 개 이상일 수 있습니다. 이 경우, 앱은 `receiverChatControls`의 각 로컬 채팅 컨트롤에 대해 [PartyLocalChatControl::GetLanguage()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage)를 통해 얻은 언어 코드와 `translations` 내 각 PartyTranslation의 `languageCode` 필드를 비교하여 각 번역의 대상 로컬 채팅 컨트롤을 결정할 수 있습니다.

**`translations`**   [PartyTranslation](/services/playfab/multiplayer/networking/reference/structs/partytranslation)\*\
*크기 `translationCount`의 배열*

채팅 텍스트 문자열의 번역을 포함하는 배열입니다.

번역은 [PartyTextChatOptions::TranslateToLocalLanguage](/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions)가 이전에 이 디바이스에 로컬인 채팅 컨트롤에서 [PartyLocalChatControl::SetTextChatOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions)를 통해 지정된 경우 제공됩니다. 여러 로컬 채팅 컨트롤에서 번역을 활성화했고 로컬 채팅 컨트롤이 [PartyLocalDevice::CreateChatControl()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol)을 통해 서로 다른 언어를 지정한 경우 번역이 두 개 이상일 수 있습니다. 이 경우, 앱은 `receiverChatControls`의 각 로컬 채팅 컨트롤에 대해 [PartyLocalChatControl::GetLanguage()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage)를 통해 얻은 언어 코드와 `translations` 내 각 PartyTranslation의 `languageCode` 필드를 비교하여 각 번역의 대상 로컬 채팅 컨트롤을 결정할 수 있습니다.

**`options`**   [PartyChatTextReceivedOptions](/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions)

채팅 텍스트에 대한 추가 정보를 설명하는 플래그입니다.

**`originalChatText`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

수신 텍스트 채팅의 원본 버전입니다.

이 필드는 항상 원격 사용자가 보낸 필터링되지 않은 원본 텍스트입니다. 필터링이 활성화되어 있지 않은 경우 `chatText`에 대한 포인터입니다. 필터링은 활성화되어 있지만 `options` 필드에서 PartyChatTextReceivedOptions::None으로 표시된 대로 필터링이 필요하지 않은 경우, `chatText`에 대한 포인터입니다.

**`errorDetail`**   PartyError

잠재적인 오류 조건에 대한 추가 문제 해결 정보를 제공하는 진단 값입니다.

이 오류는 진단 목적으로만 사용됩니다. 오류가 발생하면 `options` 필드에 [PartyChatTextReceivedOptions::FilteredDueToError](/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions) 플래그가 존재합니다.

## Requirements

**Header:** Party.h

## See also

[Party members](/services/playfab/multiplayer/networking/reference/party_members)\
[PartyLocalDevice::CreateChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol)\
[PartyLocalChatControl::SendText](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_sendtext)\
[PartyLocalChatControl::SetTextChatOptions](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions)


## Related topics

- [PartyChatTextReceivedOptions](/ko/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions.md)
- [PartyTextChatOptions](/ko/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md)
- [PartyLocalChatControl::SendText](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_sendtext.md)
- [Using text moderation](/ko/services/playfab/community/voice-communications/concepts-text-moderation.md)
- [PlayFab Party 릴리스 정보](/ko/services/playfab/multiplayer/networking/release-notes.md)