Skip to main content

chat_manager::initialize

オブジェクト インスタンスを初期化します。

構文

パラメーター

maxChatUserCount   _In_
Type: uint32_t
任意の時点でローカル chat_manager インスタンスに追加されるローカルおよびリモート ユーザーの合計最大数。Game Chat は、ユーザー数に比例したメモリを事前に割り当てます。 defaultAudioRenderVolume   _In_range_(0,1)
Type: float
新しいユーザーに使用されるオーディオ レンダリング音量。 defaultLocalToRemoteCommunicationRelationship   _In_
Type: game_chat_communication_relationship_flags
ローカル ユーザーとリモート ユーザーの間で使用される既定の通信関係。つまり、リモート ユーザーが参加した場合、これがすべての既存のローカル ユーザーとそのリモート ユーザーとの間で使用される既定の関係になります。ローカル ユーザーが参加した場合、これがそのローカル ユーザーとすべての既存のリモート ユーザーとの間の既定の関係になります。 sharedDeviceResolutionMode   _In_
Type: game_chat_shared_device_communication_relationship_resolution_mode
通信関係が競合する共有デバイス上のユーザーに対して使用される解決モード。 speechToTextConversionMode   _In_
Type: game_chat_speech_to_text_conversion_mode
音声テキスト変換モードを構成します。 audioManipulationMode   _In_
Type: 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 イベントが生成されます。

戻り値

Type: 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
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日