跳轉到主要內容

chat_manager::initialize

初始化物件執行個體。

語法

參數

maxChatUserCount   _In_
類型:uint32_t
在任何指定時間會新增至本機 chat_manager 執行個體的本機和遠端使用者總數上限。Game Chat 會預先配置與使用者數目成比例的記憶體。 defaultAudioRenderVolume   _In_range_(0,1)
類型:float
將用於新使用者的音訊轉譯音量。 defaultLocalToRemoteCommunicationRelationship   _In_
類型:game_chat_communication_relationship_flags
本機與遠端使用者之間將使用的預設通訊關係。也就是說,當遠端使用者加入時,這會是所有現有本機使用者與該遠端使用者之間使用的預設關係。當本機使用者加入時,這會是該本機使用者與所有現有遠端使用者之間的預設關係。 sharedDeviceResolutionMode   _In_
類型:game_chat_shared_device_communication_relationship_resolution_mode
用於共用裝置上具有衝突通訊關係之使用者的解析模式。 speechToTextConversionMode   _In_
類型:game_chat_speech_to_text_conversion_mode
設定語音轉文字轉換模式。 audioManipulationMode   _In_
類型:game_chat_audio_manipulation_mode_flags
將此參數傳遞為 game_chat_audio_manipulation_mode_flags::none 時,音訊可不中斷地流經 Game Chat。傳遞此參數並設定 game_chat_audio_manipulation_mode_flags::pre_encode_stream_manipulation 位元時,可存取聊天使用者音訊資料,以便在傳送端進行處理和操作。音訊資料的存取是透過使用 pre_encode_audio_stream 物件來啟用。這些物件可使用 chat_manager::get_pre_encode_audio_streams 方法來查詢。當 Game Chat 建立、關閉和終結 pre_encode_audio_stream 物件時,將產生對應的 game_chat_stream_state_change 事件。傳遞此參數並設定 game_chat_audio_manipulation_mode_flags::post_decode_stream_manipulation 位元時,可存取聊天使用者音訊資料,以便在接收端進行處理和操作。音訊資料的存取是透過使用 post_decode_audio_source_stream 和 post_decode_audio_sink_stream 物件來啟用。這些物件可使用 chat_manager::get_post_decode_audio_source_streams 和 chat_manager::get_post_decode_audio_sink_streams 方法來查詢。當 Game Chat 建立、關閉和終結 post_decode_audio_source_stream 和 post_decode_audio_sink_stream 物件時,將產生對應的 game_chat_stream_state_change 事件。

傳回值

類型: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::cleanup() 呼叫,就無法再次呼叫 chat_manager::initialize()。 每次呼叫 chat_manager::initialize() 都應該有對應的 chat_manager::cleanup() 呼叫。

需求

標頭: GameChat2.h 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

chat_manager
chat_manager::cleanup
chat_manager::singleton_instance
chat_manager::set_memory_callbacks
chat_manager::get_memory_callbacks
chat_manager::set_thread_processor
chat_manager::get_thread_processor
pre_encode_audio_stream
post_decode_audio_source_stream
post_decode_audio_sink_stream
最後修改於 2026年10月6日