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

> game_chat_text_conversion_preference_changed_state_change

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

Represents information specific to the [game\_chat\_state\_change\_type::text\_conversion\_preference\_changed](/reference/chat/gamechat2/enums/game_chat_state_change_type) state change.

<a id="syntaxSection" />

## Syntax

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

<a id="membersSection" />

### Members

*chatUser*  \
Type: [chat\_user](/reference/chat/gamechat2/classes/chat_user/chat_user)\*

A pointer to the local user who has enabled or disabled speech-to-text or text-to-speech conversion.

Your app should call [chat\_user\_local::speech\_to\_text\_conversion\_preference\_enabled](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_speech_to_text_conversion_preference_enabled) and [chat\_user\_local::text\_to\_speech\_conversion\_preference\_enabled](/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_text_to_speech_conversion_preference_enabled) to get the new preference values.

<a id="remarksSection" />

## Remarks

This structure provides additional information for a [game\_chat\_state\_change\_type::text\_conversion\_preference\_changed](/reference/chat/gamechat2/enums/game_chat_state_change_type) state change in Game Chat 2. This state change occurs when a local user has enabled or disabled speech-to-text or text-to-speech conversion.

If this state change occurs, this structure is returned as a [game\_chat\_state\_change](/reference/chat/gamechat2/structs/game_chat_state_change) element in the [game\_chat\_state\_change\_array](/reference/chat/gamechat2/structs/game_chat_state_change#array) array retrieved when [chat\_manager::start\_processing\_state\_changes](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes) is called by your app. After confirming the state change type by checking the value of the `state_change_type` member for that `game_chat_state_change` element, you can then cast that element to this structure. You can then use this structure to obtain more information about and process the state change before the array is passed back to Game Chat 2 from your app, by calling [chat\_manager::finish\_processing\_state\_changes](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes).

For more information about processing state changes, see [Using the Game Chat 2 C++ API](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2).

<a id="requirementsSection" />

## Requirements

**Header:** GameChat2.h

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

<a id="seealsoSection" />

## See also

[Intro to 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 members](/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [game_chat_state_change_type](/reference/chat/gamechat2/enums/game_chat_state_change_type.md)
- [game_chat_state_change](/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [GameChat2 members](/reference/chat/gamechat2/gamechat2_members.md)
- [game_chat_communication_relationship_adjuster_changed_state_change](/reference/chat/gamechat2/structs/game_chat_communication_relationship_adjuster_changed_state_change.md)
- [game_chat_text_chat_received_state_change](/reference/chat/gamechat2/structs/game_chat_text_chat_received_state_change.md)