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

Initialise l'instance de l'objet.

## Syntaxe

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

### Paramètres

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

Nombre total maximal d'utilisateurs locaux et distants qui seront ajoutés à l'instance chat\_manager locale à un moment donné. Game Chat pré-alloue de la mémoire proportionnellement au nombre d'utilisateurs.

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

Volume de rendu audio qui sera utilisé pour les nouveaux utilisateurs.

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

Relation de communication par défaut qui sera utilisée entre les utilisateurs locaux et distants. Autrement dit, lorsqu'un utilisateur distant rejoint la session, il s'agit de la relation par défaut utilisée entre tous les utilisateurs locaux existants et cet utilisateur distant. Lorsqu'un utilisateur local rejoint la session, il s'agit de la relation par défaut entre cet utilisateur local et tous les utilisateurs distants existants.

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

Mode de résolution utilisé pour les utilisateurs d'un appareil partagé dont les relations de communication sont en conflit.

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

Configure le mode de conversion de la parole en texte.

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

Passer ce paramètre avec la valeur game\_chat\_audio\_manipulation\_mode\_flags::none permet à l'audio de transiter par Game Chat sans interruption. Passer ce paramètre avec le bit game\_chat\_audio\_manipulation\_mode\_flags::pre\_encode\_stream\_manipulation défini donne accès aux données audio des utilisateurs du chat pour leur traitement et leur manipulation côté émetteur. L'accès aux données audio est assuré par les objets [pre\_encode\_audio\_stream](/fr/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream). Ces objets peuvent être interrogés à l'aide de la méthode [chat\_manager::get\_pre\_encode\_audio\_streams](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_pre_encode_audio_streams). Lorsque Game Chat crée, ferme et détruit des objets [pre\_encode\_audio\_stream](/fr/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream), des événements [game\_chat\_stream\_state\_change](/fr/reference/chat/gamechat2/structs/game_chat_stream_state_change) correspondants sont générés. Passer ce paramètre avec le bit game\_chat\_audio\_manipulation\_mode\_flags::post\_decode\_stream\_manipulation défini donne accès aux données audio des utilisateurs du chat pour leur traitement et leur manipulation côté récepteur. L'accès aux données audio est assuré par les objets [post\_decode\_audio\_source\_stream](/fr/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream) et [post\_decode\_audio\_sink\_stream](/fr/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream). Ces objets peuvent être interrogés à l'aide des méthodes [chat\_manager::get\_post\_decode\_audio\_source\_streams](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_post_decode_audio_source_streams) et [chat\_manager::get\_post\_decode\_audio\_sink\_streams](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_post_decode_audio_sink_streams). Lorsque Game Chat crée, ferme et détruit des objets [post\_decode\_audio\_source\_stream](/fr/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream) et [post\_decode\_audio\_sink\_stream](/fr/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream), des événements [game\_chat\_stream\_state\_change](/fr/reference/chat/gamechat2/structs/game_chat_stream_state_change) correspondants sont générés.

### Valeur renvoyée

Type : void

## Remarques

Cette méthode doit être appelée avant toute autre méthode, à l'exception des méthodes statiques chat\_manager::singleton\_instance(), chat\_manager::set\_memory\_callbacks(), chat\_manager::get\_memory\_callbacks(), chat\_manager::set\_thread\_processor() et chat\_manager::get\_thread\_processor(). chat\_manager::initialize() ne peut pas être rappelée sans un appel ultérieur à chat\_manager::cleanup().

Chaque appel à chat\_manager::initialize() doit avoir un appel chat\_manager::cleanup() correspondant.

## Configuration requise

**En-tête :** GameChat2.h

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[chat\_manager](/fr/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[chat\_manager::cleanup](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_cleanup)\
[chat\_manager::singleton\_instance](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_singleton_instance)\
[chat\_manager::set\_memory\_callbacks](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_memory_callbacks)\
[chat\_manager::get\_memory\_callbacks](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_memory_callbacks)\
[chat\_manager::set\_thread\_processor](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_processor)\
[chat\_manager::get\_thread\_processor](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_thread_processor)\
[pre\_encode\_audio\_stream](/fr/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream)\
[post\_decode\_audio\_source\_stream](/fr/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream)\
[post\_decode\_audio\_sink\_stream](/fr/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)
