Skip to main content
상태 변경의 ChatTextReceived 유형에 특정한 정보입니다.

Syntax

Members

senderChatControl   PartyChatControl* 텍스트 메시지를 시작한 채팅 컨트롤 개체입니다. receiverChatControlCount   uint32_t 텍스트 메시지가 전송되는 로컬 수신자 채팅 컨트롤의 수입니다. receiverChatControls   PartyLocalChatControlArray
크기 receiverChatControlCount의 배열
텍스트 메시지가 전송되는 로컬 수신자 채팅 컨트롤입니다. languageCode   PartyString 채팅 텍스트의 언어입니다. 언어는 로컬 언어로의 번역이 활성화된 경우에만 제공됩니다. 번역이 활성화되지 않았거나 번역 중에 실패가 발생한 경우, 언어 코드는 빈 문자열입니다.

언어 코드는 영어(미국)를 나타내는 en-US와 같은 BCP 47 형식입니다. 지원되는 언어 코드는 Language support에 열거되어 있습니다.
chatText   PartyString 수신된 채팅 텍스트입니다. 문자열은 null 종결자를 포함하지 않고 최대 c_maxChatTextMessageLength자까지 지정할 수 있습니다.

필터링이 활성화되어 있는 경우, 이 텍스트는 원격 사용자가 보낸 정확한 텍스트가 아닐 수 있습니다. 정확한 원본 텍스트는 originalChatText 필드에서 검색할 수 있습니다.
dataSize   uint32_t 이 텍스트 메시지와 연결된 데이터의 크기입니다. data   const void*
크기 dataSize 바이트의 버퍼
이 텍스트 메시지와 연결된 데이터입니다. translationCount   uint32_t 채팅 텍스트와 연결된 번역의 수입니다. 번역은 PartyTextChatOptions::TranslateToLocalLanguage가 이전에 이 디바이스에 로컬인 채팅 컨트롤에서 PartyLocalChatControl::SetTextChatOptions()를 통해 지정된 경우 제공됩니다. 여러 로컬 채팅 컨트롤에서 번역을 활성화했고 로컬 채팅 컨트롤이 PartyLocalDevice::CreateChatControl()을 통해 서로 다른 언어를 지정한 경우 번역이 두 개 이상일 수 있습니다. 이 경우, 앱은 receiverChatControls의 각 로컬 채팅 컨트롤에 대해 PartyLocalChatControl::GetLanguage()를 통해 얻은 언어 코드와 translations 내 각 PartyTranslation의 languageCode 필드를 비교하여 각 번역의 대상 로컬 채팅 컨트롤을 결정할 수 있습니다. translations   PartyTranslation*
크기 translationCount의 배열
채팅 텍스트 문자열의 번역을 포함하는 배열입니다. 번역은 PartyTextChatOptions::TranslateToLocalLanguage가 이전에 이 디바이스에 로컬인 채팅 컨트롤에서 PartyLocalChatControl::SetTextChatOptions()를 통해 지정된 경우 제공됩니다. 여러 로컬 채팅 컨트롤에서 번역을 활성화했고 로컬 채팅 컨트롤이 PartyLocalDevice::CreateChatControl()을 통해 서로 다른 언어를 지정한 경우 번역이 두 개 이상일 수 있습니다. 이 경우, 앱은 receiverChatControls의 각 로컬 채팅 컨트롤에 대해 PartyLocalChatControl::GetLanguage()를 통해 얻은 언어 코드와 translations 내 각 PartyTranslation의 languageCode 필드를 비교하여 각 번역의 대상 로컬 채팅 컨트롤을 결정할 수 있습니다. options   PartyChatTextReceivedOptions 채팅 텍스트에 대한 추가 정보를 설명하는 플래그입니다. originalChatText   PartyString 수신 텍스트 채팅의 원본 버전입니다. 이 필드는 항상 원격 사용자가 보낸 필터링되지 않은 원본 텍스트입니다. 필터링이 활성화되어 있지 않은 경우 chatText에 대한 포인터입니다. 필터링은 활성화되어 있지만 options 필드에서 PartyChatTextReceivedOptions::None으로 표시된 대로 필터링이 필요하지 않은 경우, chatText에 대한 포인터입니다. errorDetail   PartyError 잠재적인 오류 조건에 대한 추가 문제 해결 정보를 제공하는 진단 값입니다. 이 오류는 진단 목적으로만 사용됩니다. 오류가 발생하면 options 필드에 PartyChatTextReceivedOptions::FilteredDueToError 플래그가 존재합니다.

Requirements

Header: Party.h

See also

Party members
PartyLocalDevice::CreateChatControl
PartyLocalChatControl::SendText
PartyLocalChatControl::SetTextChatOptions
마지막 수정일 2026년 8월 13일