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

# initialize

> chat_manager::initialize

# chat\_manager::initialize

개체 인스턴스를 초기화합니다.

## 구문

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

### 매개 변수

*maxChatUserCount*   \_In\_\
형식: uint32\_t

지정된 시간에 로컬 chat\_manager 인스턴스에 추가될 로컬 및 원격 사용자의 최대 총 수입니다. Game Chat은 사용자 수에 비례하여 메모리를 미리 할당합니다.

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

새 사용자에게 사용될 오디오 렌더링 볼륨입니다.

*defaultLocalToRemoteCommunicationRelationship*   \_In\_\
형식: [game\_chat\_communication\_relationship\_flags](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_communication_relationship_flags.md)

로컬 및 원격 사용자 간에 사용될 기본 통신 관계입니다. 즉, 원격 사용자가 참여할 때 이는 모든 기존 로컬 사용자와 해당 원격 사용자 사이에 사용되는 기본 관계입니다. 로컬 사용자가 참여할 때 이는 해당 로컬 사용자와 모든 기존 원격 사용자 간의 기본 관계입니다.

*sharedDeviceResolutionMode*   \_In\_\
형식: [game\_chat\_shared\_device\_communication\_relationship\_resolution\_mode](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_shared_device_communication_relationship_resolution_mode.md)

통신 관계가 충돌하는 공유 디바이스의 사용자에 대해 사용되는 해결 모드입니다.

*speechToTextConversionMode*   \_In\_\
형식: [game\_chat\_speech\_to\_text\_conversion\_mode](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_speech_to_text_conversion_mode.md)

음성-텍스트 변환 모드를 구성합니다.

*audioManipulationMode*   \_In\_\
형식: [game\_chat\_audio\_manipulation\_mode\_flags](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_audio_manipulation_mode_flags.md)

이 매개 변수를 game\_chat\_audio\_manipulation\_mode\_flags::none으로 전달하면 오디오가 Game Chat을 통해 중단 없이 흐를 수 있습니다. 이 매개 변수를 game\_chat\_audio\_manipulation\_mode\_flags::pre\_encode\_stream\_manipulation 비트가 설정된 상태로 전달하면 보내는 쪽에서 처리 및 조작을 위해 채팅 사용자 오디오 데이터에 대한 액세스를 부여합니다. 오디오 데이터에 대한 액세스는 [pre\_encode\_audio\_stream](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream.md) 개체를 사용하여 활성화됩니다. 이러한 개체는 [chat\_manager::get\_pre\_encode\_audio\_streams](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_pre_encode_audio_streams.md) 메서드를 사용하여 쿼리할 수 있습니다. Game Chat이 [pre\_encode\_audio\_stream](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream.md) 개체를 만들거나, 닫거나, 소멸할 때 해당 [game\_chat\_stream\_state\_change](https://docs.xbox.com/ko/reference/chat/gamechat2/structs/game_chat_stream_state_change.md) 이벤트가 생성됩니다. 이 매개 변수를 game\_chat\_audio\_manipulation\_mode\_flags::post\_decode\_stream\_manipulation 비트가 설정된 상태로 전달하면 받는 쪽에서 처리 및 조작을 위해 채팅 사용자 오디오 데이터에 대한 액세스를 부여합니다. 오디오 데이터에 대한 액세스는 [post\_decode\_audio\_source\_stream](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream.md) 및 [post\_decode\_audio\_sink\_stream](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream.md) 개체를 사용하여 활성화됩니다. 이러한 개체는 [chat\_manager::get\_post\_decode\_audio\_source\_streams](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_post_decode_audio_source_streams.md) 및 [chat\_manager::get\_post\_decode\_audio\_sink\_streams](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_post_decode_audio_sink_streams.md) 메서드를 사용하여 쿼리할 수 있습니다. Game Chat이 [post\_decode\_audio\_source\_stream](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream.md) 및 [post\_decode\_audio\_sink\_stream](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream.md) 개체를 만들거나, 닫거나, 소멸할 때 해당 [game\_chat\_stream\_state\_change](https://docs.xbox.com/ko/reference/chat/gamechat2/structs/game_chat_stream_state_change.md) 이벤트가 생성됩니다.

### 반환 값

형식: void

## 설명

정적 메서드 chat\_manager::singleton\_instance(), chat\_manager::set\_memory\_callbacks(), chat\_manager::get\_memory\_callbacks(), chat\_manager::set\_thread\_processor(), chat\_manager::get\_thread\_processor()를 제외한 다른 모든 메서드 이전에 이 메서드를 호출해야 합니다. chat\_manager::initialize()는 후속 chat\_manager::cleanup() 호출 없이 다시 호출할 수 없습니다.

chat\_manager::initialize()에 대한 모든 호출에는 해당 chat\_manager::cleanup() 호출이 있어야 합니다.

## 요구 사항

**헤더:** GameChat2.h

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 관련 항목

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


## Related topics

- [Initialize](https://docs.xbox.com/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md)
- [HCInitialize](https://docs.xbox.com/ko/reference/live/httpclient/httpclient/functions/hcinitialize.md)
- [PFInitialize](https://docs.xbox.com/ko/services/playfab/api-references/c/pfcore/functions/pfinitialize_2.md)
- [XblInitialize](https://docs.xbox.com/ko/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize.md)
- [PFMultiplayerInitialize](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize.md)