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

# game_chat_transcribed_chat_received_state_change

> game_chat_transcribed_chat_received_state_change

# game\_chat\_transcribed\_chat\_received\_state\_change

[game\_chat\_state\_change\_type::transcribed\_chat\_received](/reference/chat/gamechat2/enums/game_chat_state_change_type) 상태 변경에 특화된 정보를 나타냅니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
typedef struct game_chat_transcribed_chat_received_state_change {  
    chat_user* speaker;  
    uint32_t receiver_count;  
    chat_user_array receivers;  
    PCWSTR message;  
} game_chat_transcribed_chat_received_state_change  
```

<a id="membersSection" />

### 멤버

*speaker*  \
형식: [chat\_user](/reference/chat/gamechat2/classes/chat_user/chat_user)\*

텍스트 메시지를 발신한 `chat_user` 개체에 대한 포인터입니다.

`chat_user` 개체의 포인터는 [chat\_manager::remove\_user](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user) 메서드를 통해 사용자가 로컬 [chat\_manager](/reference/chat/gamechat2/classes/chat_manager/chat_manager) 인스턴스에서 제거될 때까지 유효한 상태로 유지됩니다.

*receiver\_count*  \
형식: uint32\_t

*receivers*의 배열 요소 수입니다.

*receivers*  \_Field\_size\_(receiver\_count)\
형식: [chat\_user\_array](/reference/chat/gamechat2/classes/chat_user/chat_user#array)

텍스트 메시지가 전달되는 하나 이상의 로컬 대상 플레이어에 대한 `chat_user` 포인터의 배열입니다.

`chat_user_array` 개체에 대한 메모리는 [chat\_manager::finish\_processing\_state\_changes](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes)를 호출하여 이 개체가 반환될 때까지 유효한 상태로 유지됩니다. 개별 `chat_user` 개체 포인터는 `chat_manager::remove_user` 메서드를 통해 사용자가 로컬 `chat_manager` 인스턴스에서 제거될 때까지 유효한 상태로 유지됩니다.

*message*  \
형식: PCWSTR

*speaker* 개체와 연결된 사용자의 오디오를 필사하여 생성된 텍스트 문자열에 대한 포인터입니다. 문자열은 null 종결자를 제외하고 최대 `c_maxChatTextMessageLength` 문자 길이일 수 있습니다.

<Note>`c_maxChatTextMessageLength`는 값이 1023인 `constexpr uint16_t`입니다.</Note>

문자열은 `chat_manager::finish_processing_state_changes`를 호출하여 이 개체가 반환될 때까지 유효한 상태로 유지됩니다. 앱은 Game Chat 통신 정책 가이드 문서에 설명된 방식과 기간으로 표시하기 위해 텍스트의 복사본을 만들어야 합니다.

<a id="remarksSection" />

## 설명

이 구조체는 Game Chat 2의 [game\_chat\_state\_change\_type::transcribed\_chat\_received](/reference/chat/gamechat2/enums/game_chat_state_change_type) 상태 변경에 대한 추가 정보를 제공합니다. 이 상태 변경은 원격 플레이어의 음성 통신이 필사되어 하나 이상의 로컬 사용자에게 표시되어야 할 때 발생합니다.

이 상태 변경이 발생하면, 이 구조체는 앱이 [chat\_manager::start\_processing\_state\_changes](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes)를 호출할 때 검색되는 [game\_chat\_state\_change\_array](/reference/chat/gamechat2/structs/game_chat_state_change#array) 배열의 [game\_chat\_state\_change](/reference/chat/gamechat2/structs/game_chat_state_change) 요소로 반환됩니다. 해당 `game_chat_state_change` 요소의 `state_change_type` 멤버 값을 확인하여 상태 변경 유형을 확인한 후, 해당 요소를 이 구조체로 캐스팅할 수 있습니다. 그런 다음 [chat\_manager::finish\_processing\_state\_changes](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes)를 호출하여 배열이 앱에서 Game Chat 2로 다시 전달되기 전에 이 구조체를 사용하여 상태 변경에 대한 자세한 정보를 얻고 처리할 수 있습니다.

상태 변경 처리에 대한 자세한 내용은 [Game Chat 2 C++ API 사용](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)을 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** GameChat2.h

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

<a id="seealsoSection" />

## 개념 설명서

* [Game Chat 2 C++ API 사용](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## 함께 보기

[Game Chat 2 소개](/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[GameChat2 멤버](/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [Game Chat 2 C++ API 사용](/ko/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [game_chat_state_change_type](/ko/reference/chat/gamechat2/enums/game_chat_state_change_type.md)
- [game_chat_state_change](/ko/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [GameChat2 멤버](/ko/reference/chat/gamechat2/gamechat2_members.md)
- [game_chat_speech_to_text_conversion_mode](/ko/reference/chat/gamechat2/enums/game_chat_speech_to_text_conversion_mode.md)