chat_manager::initialize
Initialise l’instance de l’objet.Syntaxe
Paramètres
maxChatUserCount _In_Type : uint32_t 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 Volume de rendu audio qui sera utilisé pour les nouveaux utilisateurs. defaultLocalToRemoteCommunicationRelationship _In_
Type : game_chat_communication_relationship_flags Relation de communication par défaut qui sera utilisée entre les utilisateurs locaux et distants. Autrement dit, lorsqu’un utilisateur distant rejoint la session, il s’agit de la relation par défaut utilisée entre tous les utilisateurs locaux existants et cet utilisateur distant. Lorsqu’un utilisateur local rejoint la session, il s’agit 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 Mode de résolution utilisé pour les utilisateurs d’un appareil partagé dont les relations de communication sont en conflit. speechToTextConversionMode _In_
Type : 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 Passer ce paramètre avec la valeur game_chat_audio_manipulation_mode_flags::none permet à l’audio de transiter par 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 chat pour leur traitement et leur manipulation côté émetteur. L’accès aux données audio est assuré par les objets pre_encode_audio_stream. Ces objets peuvent être interrogés à l’aide de la méthode chat_manager::get_pre_encode_audio_streams. Lorsque Game Chat crée, ferme et détruit des objets pre_encode_audio_stream, des événements 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 chat pour leur traitement et leur manipulation côté récepteur. L’accès aux données audio est assuré par les objets post_decode_audio_source_stream et post_decode_audio_sink_stream. Ces objets peuvent être interrogés à l’aide des méthodes chat_manager::get_post_decode_audio_source_streams et chat_manager::get_post_decode_audio_sink_streams. Lorsque Game Chat crée, ferme et détruit des objets post_decode_audio_source_stream et post_decode_audio_sink_stream, des événements game_chat_stream_state_change correspondants sont générés.
Valeur renvoyée
Type : voidRemarques
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 rappelée sans un appel ultérieur à chat_manager::cleanup(). Chaque appel à chat_manager::initialize() doit avoir un appel chat_manager::cleanup() correspondant.Configuration requise
En-tête : GameChat2.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
chat_managerchat_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