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

Le 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

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

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

La relation de communication par défaut qui sera utilisée entre les utilisateurs locaux et distants. Autrement dit, lorsqu'un utilisateur distant se joint, il s'agira de la relation par défaut utilisée entre tous les utilisateurs locaux existants et cet utilisateur distant. Lorsqu'un utilisateur local se joint, il s'agira 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-CA/reference/chat/gamechat2/enums/game_chat_shared_device_communication_relationship_resolution_mode)

Le mode de résolution utilisé pour les utilisateurs d'un appareil partagé qui ont des relations de communication conflictuelles.

*speechToTextConversionMode*   \_In\_\
Type : [game\_chat\_speech\_to\_text\_conversion\_mode](/fr-CA/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-CA/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 circuler dans 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 clavardage pour le traitement et la manipulation du côté de l'expéditeur. L'accès aux données audio est activé au moyen des objets [pre\_encode\_audio\_stream](/fr-CA/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-CA/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-CA/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream), des événements [game\_chat\_stream\_state\_change](/fr-CA/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 clavardage pour le traitement et la manipulation du côté du destinataire. L'accès aux données audio est activé au moyen des objets [post\_decode\_audio\_source\_stream](/fr-CA/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream) et [post\_decode\_audio\_sink\_stream](/fr-CA/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-CA/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-CA/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-CA/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream) et [post\_decode\_audio\_sink\_stream](/fr-CA/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream), des événements [game\_chat\_stream\_state\_change](/fr-CA/reference/chat/gamechat2/structs/game_chat_stream_state_change) correspondants sont générés.

### Valeur de retour

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 appelée de nouveau sans un appel subséquent à chat\_manager::cleanup().

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

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