> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# game_chat_text_conversion_preference_changed_state_change

> game_chat_text_conversion_preference_changed_state_change

# game\_chat\_text\_conversion\_preference\_changed\_state\_change

[game\_chat\_state\_change\_type::text\_conversion\_preference\_changed](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_state_change_type.md) 상태 변경에 특화된 정보를 나타냅니다.

## 구문

```cpp theme={null}
typedef struct game_chat_text_conversion_preference_changed_state_change {  
    chat_user* chatUser;  
} game_chat_text_conversion_preference_changed_state_change  
```

### 멤버

*chatUser*  \
형식: [chat\_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user.md)\*

음성-텍스트 또는 텍스트 음성 변환을 활성화하거나 비활성화한 로컬 사용자에 대한 포인터입니다.

앱은 새 기본 설정 값을 가져오기 위해 [chat\_user\_local::speech\_to\_text\_conversion\_preference\_enabled](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_speech_to_text_conversion_preference_enabled.md) 및 [chat\_user\_local::text\_to\_speech\_conversion\_preference\_enabled](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_text_to_speech_conversion_preference_enabled.md)를 호출해야 합니다.

## 설명

이 구조체는 Game Chat 2의 [game\_chat\_state\_change\_type::text\_conversion\_preference\_changed](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_state_change_type.md) 상태 변경에 대한 추가 정보를 제공합니다. 이 상태 변경은 로컬 사용자가 음성-텍스트 또는 텍스트 음성 변환을 활성화하거나 비활성화했을 때 발생합니다.

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

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

## 요구 사항

**헤더:** GameChat2.h

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

## 함께 보기

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


## Related topics

- [game_chat_state_change_type](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_state_change_type.md)
- [game_chat_state_change](https://docs.xbox.com/ko/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [GameChat2 멤버(API 콘텐츠)](https://docs.xbox.com/ko/reference/chat/gamechat2/gamechat2_members.md)
- [game_chat_communication_relationship_adjuster_changed_state_change](https://docs.xbox.com/ko/reference/chat/gamechat2/structs/game_chat_communication_relationship_adjuster_changed_state_change.md)
- [game_chat_text_chat_received_state_change](https://docs.xbox.com/ko/reference/chat/gamechat2/structs/game_chat_text_chat_received_state_change.md)