다음을 통해 공유

PartyChatTextReceivedStateChange

  • 아티클

ChatTextReceived 상태 변경 유형과 관련된 정보입니다.

구문

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;  
}

멤버

senderChatControl PartyChatControl*

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

receiverChatControlCount uint32_t

문자 메시지를 받는 로컬 수신기 채팅 컨트롤의 수입니다.

receiverChatControls PartyLocalChatControlArray
receiverChatControlCount 크기 배열

문자 메시지를 받는 로컬 수신기 채팅 컨트롤입니다.

languageCode PartyString

채팅 문자의 언어입니다.

언어는 현지 언어 번역을 사용하도록 설정한 경우에만 제공됩니다. 번역을 사용할 수 없거나 번역 중에 오류가 발생한 경우 언어 코드는 빈 문자열입니다.

언어 코드는 BCP 47 형식(예: 영어(미국)의 경우 en-US)입니다. 지원되는 언어 코드는 언어 지원에 열거되어 있습니다.

chatText PartyString

받은 채팅 문자입니다.

문자열은 최대 c_maxChatTextMessageLength자일 수 있으며, Null 종결자를 포함하지 않습니다.

필터링을 사용하도록 설정한 경우 이 문자는 원격 사용자가 보낸 문자와 정확히 일치하지 않을 수 있습니다. 정확한 원본 문자는 originalChatText 필드에서 검색할 수 있습니다.

dataSize uint32_t

이 문자 메시지와 연결된 데이터의 크기입니다.

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

이 문자 메시지와 연결된 데이터입니다.

translationCount uint32_t

채팅 문자와 연결된 번역 수입니다.

번역은 이 디바이스의 로컬 채팅 컨트롤에서 PartyLocalChatControl::SetTextChatOptions()를 통해 PartyTextChatOptions::TranslateToLocalLanguage를 이미 지정한 경우에 제공됩니다. 여러 로컬 채팅 컨트롤에서 번역을 사용하도록 설정하고 로컬 채팅 컨트롤이 PartyLocalDevice::CreateChatControl()을 통해 다른 언어를 지정한 경우 둘 이상의 번역이 있을 수 있습니다. 이 경우 앱은 translations에서 각 PartyTranslation의 languageCode 필드를 receiverChatControls의 각 로컬 채팅 컨트롤에 대해 PartyLocalChatControl::GetLanguage()를 통해 가져온 언어 코드와 비교하여 각 번역의 대상 로컬 채팅 컨트롤을 확인할 수 있습니다.

translations PartyTranslation*
translationCount 크기 배열

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

번역은 이 디바이스의 로컬 채팅 컨트롤에서 PartyLocalChatControl::SetTextChatOptions()를 통해 PartyTextChatOptions::TranslateToLocalLanguage를 이미 지정한 경우에 제공됩니다. 여러 로컬 채팅 컨트롤에서 번역을 사용하도록 설정하고 로컬 채팅 컨트롤이 PartyLocalDevice::CreateChatControl()을 통해 다른 언어를 지정한 경우 둘 이상의 번역이 있을 수 있습니다. 이 경우 앱은 translations에서 각 PartyTranslation의 languageCode 필드를 receiverChatControls의 각 로컬 채팅 컨트롤에 대해 PartyLocalChatControl::GetLanguage()를 통해 가져온 언어 코드와 비교하여 각 번역의 대상 로컬 채팅 컨트롤을 확인할 수 있습니다.

options PartyChatTextReceivedOptions

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

originalChatText PartyString

들어오는 문자 채팅의 원래 버전입니다.

이 필드에는 항상 원격 사용자가 보낸 필터링되지 않은 원본 문자가 표시됩니다. 필터링을 사용하지 않도록 설정한 경우 chatText에 대한 포인터입니다. 필터링을 사용할 수 있지만 필터링이 필요하지 않은 경우 options 필드에 있는 PartyChatTextReceivedOptions::None에 표시된 대로 chatText에 대한 포인터입니다.

errorDetail PartyError

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

이 오류는 진단 목적으로만 제공됩니다. 오류가 발생하면 PartyChatTextReceivedOptions::FilteredDueToError 플래그가 options 필드에 표시됩니다.

요구 사항

헤더: Party.h

참고 항목

파티 멤버
PartyLocalDevice::CreateChatControl
PartyLocalChatControl::SendText
PartyLocalChatControl::SetTextChatOptions