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

Representa informações específicas da alteração de estado [game\_chat\_state\_change\_type::text\_conversion\_preference\_changed](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/enums/game_chat_state_change_type.md).

## Sintaxe

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

### Membros

*chatUser*  \
Tipo: [chat\_user](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user.md)\*

Um ponteiro para o usuário local que habilitou ou desabilitou a conversão de fala em texto ou de texto em fala.

Seu aplicativo deve chamar [chat\_user\_local::speech\_to\_text\_conversion\_preference\_enabled](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_speech_to_text_conversion_preference_enabled.md) e [chat\_user\_local::text\_to\_speech\_conversion\_preference\_enabled](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_text_to_speech_conversion_preference_enabled.md) para obter os novos valores de preferência.

## Comentários

Essa estrutura fornece informações adicionais para uma alteração de estado [game\_chat\_state\_change\_type::text\_conversion\_preference\_changed](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/enums/game_chat_state_change_type.md) no Game Chat 2. Essa alteração de estado ocorre quando um usuário local habilita ou desabilita a conversão de fala em texto ou de texto em fala.

Se essa alteração de estado ocorrer, essa estrutura será retornada como um elemento [game\_chat\_state\_change](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/structs/game_chat_state_change.md) na matriz [game\_chat\_state\_change\_array](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/structs/game_chat_state_change.md#array) recuperada quando [chat\_manager::start\_processing\_state\_changes](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes.md) for chamado pelo seu aplicativo. Depois de confirmar o tipo de alteração de estado verificando o valor do membro `state_change_type` desse elemento `game_chat_state_change`, você pode converter esse elemento para essa estrutura. Em seguida, você pode usar essa estrutura para obter mais informações sobre a alteração de estado e processá-la antes que a matriz seja devolvida ao Game Chat 2 pelo seu aplicativo, chamando [chat\_manager::finish\_processing\_state\_changes](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes.md).

Para obter mais informações sobre o processamento de alterações de estado, consulte [Usando a API C++ do Game Chat 2](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md).

## Requisitos

**Cabeçalho:** GameChat2.h

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Introdução ao Game Chat 2](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro.md)\
[chat\_manager](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/chat_manager.md)\
[Membros do GameChat2](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/gamechat2_members.md)


## Related topics

- [game_chat_state_change_type](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/enums/game_chat_state_change_type.md)
- [game_chat_state_change](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [Membros do GameChat2 (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/gamechat2_members.md)
- [game_chat_communication_relationship_adjuster_changed_state_change](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/structs/game_chat_communication_relationship_adjuster_changed_state_change.md)
- [game_chat_text_chat_received_state_change](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/structs/game_chat_text_chat_received_state_change.md)