chat_manager::initialize
Initialise l’instance de l’objet.Syntaxe
Paramètres
maxChatUserCount _In_Type : uint32_t Le 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 Le volume de rendu audio qui sera utilisé pour les nouveaux utilisateurs. defaultLocalToRemoteCommunicationRelationship _In_
Type : game_chat_communication_relationship_flags La relation de communication par défaut qui sera utilisée entre les utilisateurs locaux et distants. Autrement dit, lorsqu’un utilisateur distant se joint, il s’agira de la relation par défaut utilisée entre tous les utilisateurs locaux existants et cet utilisateur distant. Lorsqu’un utilisateur local se joint, il s’agira 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 Le mode de résolution utilisé pour les utilisateurs d’un appareil partagé qui ont des relations de communication conflictuelles. 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 circuler dans 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 clavardage pour le traitement et la manipulation du côté de l’expéditeur. L’accès aux données audio est activé au moyen des 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 clavardage pour le traitement et la manipulation du côté du destinataire. L’accès aux données audio est activé au moyen des 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 de retour
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 appelée de nouveau sans un appel subséquent à chat_manager::cleanup(). Chaque appel à chat_manager::initialize() doit avoir un appel correspondant à chat_manager::cleanup().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