PartyVoiceChatTranscriptionReceivedStateChange

아티클
01/22/2024

VoiceChatTranscriptionReceived 형식의 상태 변경과 관련된 정보입니다.

구문

struct PartyVoiceChatTranscriptionReceivedStateChange : PartyStateChange {  
    PartyStateChangeResult result;  
    PartyError errorDetail;  
    PartyChatControl* senderChatControl;  
    uint32_t receiverChatControlCount;  
    PartyLocalChatControlArray receiverChatControls;  
    PartyAudioSourceType sourceType;  
    PartyString languageCode;  
    PartyString transcription;  
    PartyVoiceChatTranscriptionPhraseType type;  
    uint32_t translationCount;  
    PartyTranslation* translations;  
}

멤버

resultPartyStateChangeResult

대화 내용 기록 작업이 성공했음을 나타내거나 실패한 이유를 제공합니다.

성공하면 transcription 필드는 길이가 0이 아닌 문자열이 됩니다. 실패 시 문자열이 비어 있습니다. 실패는 스피커에 대해 대화 내용 기록 작업이 시도되었지만 완료할 수 없음을 나타냅니다. 채팅 컨트롤과 연결된 사용자의 요청에 따라 대화 내용 기록을 사용하고 대화 내용 기록 메시지가 UI를 통해 표시되는 경우 대화 내용 기록이 보류 중인지 실패했는지에 대한 피드백을 제공하려면 실패도 사용자에게 표시하는 것이 좋습니다.

errorDetail PartyError

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

사용자가 읽을 수 있는 형식의 오류 세부 정보는 PartyManager::GetErrorMessage()를 통해 검색할 수 있습니다.

senderChatControlPartyChatControl*

대화 내용 기록 메시지를 시작한 채팅 컨트롤 개체입니다.

receiverChatControlCount uint32_t

대화 내용 기록을 받는 로컬 수신기 채팅 컨트롤의 수입니다.

receiverChatControlsPartyLocalChatControlArray
크기 배열 receiverChatControlCount

대화 내용 기록을 받는 로컬 수신기 채팅 컨트롤입니다.

sourceTypePartyAudioSourceType

이 대화 내용 기록이 나타내는 오디오 원본의 형식입니다.

오디오 원본 형식은 다른 원본 형식의 대화 내용 기록을 다르게 처리해야 하는 게임 시나리오에 선택적으로 사용할 수 있습니다. 예를 들어 대화 내용 기록이 마이크와 관련되는지 텍스트 음성 변환 오디오와 관련되는지에 따라 다른 아이콘 체계가 표시될 수 있습니다.

languageCodePartyString

대화 내용 기록의 언어 코드입니다.

언어 코드는 result 필드가 성공을 나타내는 경우 항상 제공됩니다. 그러지 않으면 언어 코드는 빈 문자열이 됩니다.

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

transcriptionPartyString

대화 내용이 기록된 음성 채팅 문자입니다.

문자열은 최대 c_maxChatTextMessageLength자일 수 있으며, null 종결자를 포함하지 않습니다. result 필드가 실패를 나타내는 경우 문자열은 항상 비어 있습니다.

typePartyVoiceChatTranscriptionPhraseType

transcription 필드에 제공된 텍스트의 구 형식을 나타냅니다.

result 필드가 실패를 나타내는 경우 형식은 항상 PartyVoiceChatTranscriptionPhraseType::Final입니다.

translationCount uint32_t

대화 내용이 기록된 음성 채팅 문자와 연결된 번역 수입니다.

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

translationsPartyTranslation*
크기 배열 translationCount

음성 채팅 대화 내용 기록 문자열의 번역을 포함하는 배열입니다.

요구 사항

헤더: Party.h

참고 항목

파티 멤버
PartyLocalDevice::CreateChatControl
PartyLocalChatControl::SetTranscriptionOptions

다음을 통해 공유

PartyVoiceChatTranscriptionReceivedStateChange

구문

멤버

요구 사항

참고 항목

추가 리소스