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

# PartyVoiceChatTranscriptionReceivedStateChange

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

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

## Syntax

```cpp theme={null}
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;  
}  
```

### Members

**`result`**   [PartyStateChangeResult](/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult)

필사 작업이 성공했음을 나타내거나 실패한 이유를 제공합니다.

성공 시, `transcription` 필드는 길이가 0이 아닌 문자열입니다. 실패 시, 문자열은 비어 있습니다. 실패는 화자에 대해 필사 작업이 시도되었지만 완료할 수 없었음을 나타냅니다. 채팅 제어와 관련된 사용자의 요청에 따라 필사가 활성화되었고 필사 메시지가 UI를 통해 표시되는 경우, 필사가 보류 중인지 또는 실패했는지에 대한 피드백을 제공하기 위해 실패도 사용자에게 표시하는 것이 좋습니다.

**`errorDetail`**   PartyError

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

이 오류 세부 정보의 사람이 읽을 수 있는 형태는 [PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage)를 통해 가져올 수 있습니다.

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

필사 메시지를 발신한 채팅 제어 개체입니다.

**`receiverChatControlCount`**   uint32\_t

필사가 전달되는 로컬 수신자 채팅 제어의 수입니다.

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

필사가 전달되는 로컬 수신자 채팅 제어입니다.

**`sourceType`**   [PartyAudioSourceType](/services/playfab/multiplayer/networking/reference/enums/partyaudiosourcetype)

이 필사가 나타내는 오디오 원본의 유형입니다.

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

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

필사의 언어 코드입니다.

`result` 필드가 성공을 나타낼 때 언어 코드는 항상 제공됩니다. 그렇지 않으면 언어 코드는 빈 문자열입니다. <br /><br /> 언어 코드는 en-US(영어(미국))와 같은 BCP 47 형식입니다. 지원되는 언어 코드는 [언어 지원](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support)에 열거되어 있습니다.

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

필사된 음성 채팅 텍스트입니다.

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

**`type`**   [PartyVoiceChatTranscriptionPhraseType](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionphrasetype)

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

`result` 필드가 실패를 나타내는 경우 유형은 항상 [PartyVoiceChatTranscriptionPhraseType::Final](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionphrasetype)입니다.

**`translationCount`**   uint32\_t

필사된 음성 채팅 텍스트와 관련된 번역의 수입니다.

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

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

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

이 디바이스에 로컬인 채팅 제어에 대해 [PartyLocalChatControl::SetTranscriptionOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions)을 통해 [PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions)이 이전에 지정된 경우 번역이 제공됩니다. 여러 로컬 채팅 제어가 번역을 활성화했고 로컬 채팅 제어가 [PartyLocalDevice::CreateChatControl()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol)을 통해 서로 다른 언어를 지정한 경우 번역이 두 개 이상 있을 수 있습니다. 그 경우, 앱은 `translations`의 각 PartyTranslation의 `languageCode` 필드를 `receiverChatControls`의 각 로컬 채팅 제어에 대해 [PartyLocalChatControl::GetLanguage()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage)을 통해 얻은 언어 코드와 비교하여 각 번역의 대상 로컬 채팅 제어를 결정할 수 있습니다. <br /><br /> 번역을 활성화한 `receiverChatControls`의 각 채팅 제어에 대한 언어에 해당하는 번역이 제공됩니다. 이는 말하는 채팅 제어의 언어가 로컬 채팅 제어의 언어와 같더라도 마찬가지입니다. 이러한 경우 필사 문자열과 번역 문자열이 동일합니다.

## Requirements

**Header:** Party.h

## 함께 보기

[Party members](/services/playfab/multiplayer/networking/reference/party_members)\
[PartyLocalDevice::CreateChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol)\
[PartyLocalChatControl::SetTranscriptionOptions](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions)


## Related topics

- [PartyVoiceChatTranscriptionOptions](/ko/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md)
- [PartyVoiceChatTranscriptionPhraseType](/ko/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionphrasetype.md)
- [PartyLocalChatControl::GetTranscriptionOptions](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_gettranscriptionoptions.md)
- [PlayFab Party 릴리스 정보](/ko/services/playfab/multiplayer/networking/release-notes.md)
- [PartyLocalChatControl::SetTranscriptionOptions](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)