> ## 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 la instancia del objeto.

## Sintaxis

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

El número total máximo de usuarios locales y remotos que se agregarán a la instancia local de chat\_manager en un momento dado. Game Chat asigna previamente memoria proporcional al número de usuarios.

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

El volumen de representación de audio que se usará para los nuevos usuarios.

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

La relación de comunicación predeterminada que se usará entre los usuarios locales y remotos. Es decir, cuando un usuario remoto se una, esta será la relación predeterminada que se use entre todos los usuarios locales existentes y ese usuario remoto. Cuando un usuario local se una, esta será la relación predeterminada entre ese usuario local y todos los usuarios remotos existentes.

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

El modo de resolución usado para los usuarios de un dispositivo compartido que tienen relaciones de comunicación en conflicto.

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

Configura el modo de conversión de voz a texto.

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

Pasar este parámetro como game\_chat\_audio\_manipulation\_mode\_flags::none permite que el audio fluya a través de Game Chat sin interrupciones. Pasar este parámetro con el bit game\_chat\_audio\_manipulation\_mode\_flags::pre\_encode\_stream\_manipulation establecido concede acceso a los datos de audio de los usuarios de chat para su procesamiento y manipulación en el lado del emisor. El acceso a los datos de audio se habilita mediante el uso de los objetos [pre\_encode\_audio\_stream](/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream). Estos objetos se pueden consultar mediante el método [chat\_manager::get\_pre\_encode\_audio\_streams](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_pre_encode_audio_streams). Cuando Game Chat crea, cierra y destruye objetos [pre\_encode\_audio\_stream](/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream), se generarán los eventos [game\_chat\_stream\_state\_change](/reference/chat/gamechat2/structs/game_chat_stream_state_change) correspondientes. Pasar este parámetro con el bit game\_chat\_audio\_manipulation\_mode\_flags::post\_decode\_stream\_manipulation establecido concede acceso a los datos de audio de los usuarios de chat para su procesamiento y manipulación en el lado del receptor. El acceso a los datos de audio se habilita mediante el uso de los objetos [post\_decode\_audio\_source\_stream](/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream) y [post\_decode\_audio\_sink\_stream](/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream). Estos objetos se pueden consultar mediante los métodos [chat\_manager::get\_post\_decode\_audio\_source\_streams](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_post_decode_audio_source_streams) y [chat\_manager::get\_post\_decode\_audio\_sink\_streams](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_post_decode_audio_sink_streams). Cuando Game Chat crea, cierra y destruye objetos [post\_decode\_audio\_source\_stream](/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream) y [post\_decode\_audio\_sink\_stream](/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream), se generarán los eventos [game\_chat\_stream\_state\_change](/reference/chat/gamechat2/structs/game_chat_stream_state_change) correspondientes.

### Valor devuelto

Tipo: void

## Comentarios

Se debe llamar a este método antes que a cualquier otro método, aparte de los métodos estáticos chat\_manager::singleton\_instance(), chat\_manager::set\_memory\_callbacks(), chat\_manager::get\_memory\_callbacks(), chat\_manager::set\_thread\_processor() y chat\_manager::get\_thread\_processor(). No se puede volver a llamar a chat\_manager::initialize() sin una llamada posterior a chat\_manager::cleanup().

Cada llamada a chat\_manager::initialize() debe tener una llamada correspondiente a chat\_manager::cleanup().

## Requisitos

**Encabezado:** GameChat2.h

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

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


## Related topics

- [chat_manager::cleanup](/es/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_cleanup.md)
- [chat_manager::set_thread_processor](/es/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_processor.md)
- [chat_manager::set_thread_affinity_mask](/es/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_affinity_mask.md)
- [chat_manager::set_legacy_era_uwp_compat_mode_enabled](/es/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_legacy_era_uwp_compat_mode_enabled.md)
- [chat_manager::add_remote_user](/es/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)
