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

# chat_manager::initialize

> chat_manager::initialize

# chat\_manager::initialize

Inicializa a instância do objeto.

## Sintaxe

```cpp theme={null}
void initialize(  
    uint32_t maxChatUserCount,  
    float defaultAudioRenderVolume= 1.0f,  
    game_chat_communication_relationship_flags defaultLocalToRemoteCommunicationRelationship= game_chat_communication_relationship_flags none,  
    game_chat_shared_device_communication_relationship_resolution_mode sharedDeviceResolutionMode= game_chat_shared_device_communication_relationship_resolution_mode permissive,  
    game_chat_speech_to_text_conversion_mode speechToTextConversionMode= game_chat_speech_to_text_conversion_mode automatic,  
    game_chat_audio_manipulation_mode_flags audioManipulationMode= game_chat_audio_manipulation_mode_flags none  
)  
```

### Parâmetros

*maxChatUserCount*   \_In\_\
Tipo: uint32\_t

O número total máximo de usuários locais e remotos que serão adicionados à instância local de chat\_manager a qualquer momento. O Game Chat pré-aloca memória proporcional ao número de usuários.

*defaultAudioRenderVolume*   \_In\_range\_(0,1)\
Tipo: float

O volume de renderização de áudio que será usado para novos usuários.

*defaultLocalToRemoteCommunicationRelationship*   \_In\_\
Tipo: [game\_chat\_communication\_relationship\_flags](/pt-BR/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags)

A relação de comunicação padrão que será usada entre usuários locais e remotos. Ou seja, quando um usuário remoto ingressar, essa será a relação padrão usada entre todos os usuários locais existentes e esse usuário remoto. Quando um usuário local ingressar, essa será a relação padrão entre esse usuário local e todos os usuários remotos existentes.

*sharedDeviceResolutionMode*   \_In\_\
Tipo: [game\_chat\_shared\_device\_communication\_relationship\_resolution\_mode](/pt-BR/reference/chat/gamechat2/enums/game_chat_shared_device_communication_relationship_resolution_mode)

O modo de resolução usado para usuários em um dispositivo compartilhado que tenham relações de comunicação conflitantes.

*speechToTextConversionMode*   \_In\_\
Tipo: [game\_chat\_speech\_to\_text\_conversion\_mode](/pt-BR/reference/chat/gamechat2/enums/game_chat_speech_to_text_conversion_mode)

Configura o modo de conversão de fala em texto.

*audioManipulationMode*   \_In\_\
Tipo: [game\_chat\_audio\_manipulation\_mode\_flags](/pt-BR/reference/chat/gamechat2/enums/game_chat_audio_manipulation_mode_flags)

Passar este parâmetro como game\_chat\_audio\_manipulation\_mode\_flags::none permite que o áudio flua pelo Game Chat sem interrupção. Passar este parâmetro com o bit game\_chat\_audio\_manipulation\_mode\_flags::pre\_encode\_stream\_manipulation definido concede acesso aos dados de áudio do usuário do chat para processamento e manipulação no lado do remetente. O acesso aos dados de áudio é habilitado por meio do uso dos objetos [pre\_encode\_audio\_stream](/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream). Esses objetos podem ser consultados usando o método [chat\_manager::get\_pre\_encode\_audio\_streams](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_pre_encode_audio_streams). Quando o Game Chat cria, fecha e destrói objetos [pre\_encode\_audio\_stream](/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream), eventos [game\_chat\_stream\_state\_change](/pt-BR/reference/chat/gamechat2/structs/game_chat_stream_state_change) correspondentes são gerados. Passar este parâmetro com o bit game\_chat\_audio\_manipulation\_mode\_flags::post\_decode\_stream\_manipulation definido concede acesso aos dados de áudio do usuário do chat para processamento e manipulação no lado do destinatário. O acesso aos dados de áudio é habilitado por meio do uso dos objetos [post\_decode\_audio\_source\_stream](/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream) e [post\_decode\_audio\_sink\_stream](/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream). Esses objetos podem ser consultados usando os métodos [chat\_manager::get\_post\_decode\_audio\_source\_streams](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_post_decode_audio_source_streams) e [chat\_manager::get\_post\_decode\_audio\_sink\_streams](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_post_decode_audio_sink_streams). Quando o Game Chat cria, fecha e destrói objetos [post\_decode\_audio\_source\_stream](/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream) e [post\_decode\_audio\_sink\_stream](/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream), eventos [game\_chat\_stream\_state\_change](/pt-BR/reference/chat/gamechat2/structs/game_chat_stream_state_change) correspondentes são gerados.

### Valor retornado

Tipo: void

## Comentários

Este método deve ser chamado antes de qualquer outro método, exceto os métodos estáticos chat\_manager::singleton\_instance(), chat\_manager::set\_memory\_callbacks(), chat\_manager::get\_memory\_callbacks(), chat\_manager::set\_thread\_processor() e chat\_manager::get\_thread\_processor(). chat\_manager::initialize() não pode ser chamado novamente sem uma chamada subsequente a chat\_manager::cleanup().

Cada chamada a chat\_manager::initialize() deve ter uma chamada correspondente a chat\_manager::cleanup().

## Requisitos

**Cabeçalho:** GameChat2.h

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

## Confira também

[chat\_manager](/pt-BR/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[chat\_manager::cleanup](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_cleanup)\
[chat\_manager::singleton\_instance](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_singleton_instance)\
[chat\_manager::set\_memory\_callbacks](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_memory_callbacks)\
[chat\_manager::get\_memory\_callbacks](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_memory_callbacks)\
[chat\_manager::set\_thread\_processor](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_processor)\
[chat\_manager::get\_thread\_processor](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_thread_processor)\
[pre\_encode\_audio\_stream](/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream)\
[post\_decode\_audio\_source\_stream](/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream)\
[post\_decode\_audio\_sink\_stream](/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream)


## Related topics

- [chat_manager::initialize](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_initialize.md)
- [chat_manager::cleanup](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_cleanup.md)
- [chat_manager::set_thread_processor](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_processor.md)