Skip to main content

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_streampost_decode_audio_sink_stream 对象来启用对音频数据的访问。可以使用 chat_manager::get_post_decode_audio_source_streamschat_manager::get_post_decode_audio_sink_streams 方法查询这些对象。当 Game Chat 创建、关闭和销毁 post_decode_audio_source_streampost_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年8月24日