PartyRegionUpdateMode

Modes de configuration représentant la façon dont la bibliothèque Party effectue la découverte automatique des régions et la mesure de la qualité de connexion dans le cadre de la structure PartyRegionUpdateConfiguration.

Syntaxe

enum class PartyRegionUpdateMode    
{  
    Immediate = 0,  
    Deferred = 1,  
}  

Constantes

Constante	Description
Immediate	Commencer automatiquement, dès que possible, à récupérer la liste des régions disponibles et à mesurer la qualité de connexion à celles-ci. La bibliothèque Party découvre automatiquement les régions disponibles et mesure la qualité de connexion à celles-ci lors du premier appel à PartyManager::Initialize(). La bibliothèque Party actualise également périodiquement la liste et les mesures de qualité jusqu’à l’appel de PartyManager::Cleanup(). Si l’appareil est déjà connecté ou en cours de connexion à un réseau Party existant, l’actualisation est différée jusqu’à la déconnexion de tous les réseaux Party. L’intervalle d’actualisation périodique peut être configuré à l’aide du champ refreshIntervalInSeconds de la structure PartyRegionUpdateConfiguration qui le contient. L’application reçoit automatiquement un PartyRegionsChangedStateChange indiquant les régions disponibles ou le PartyStateChangeResult d’échec chaque fois qu’une opération de mesure se termine. Ce mode est la valeur par défaut lorsque PartyOption::RegionUpdateConfiguration n’a pas été configurée.
Deferred	Différer la récupération de la liste des régions disponibles et la mesure de la qualité de connexion à celles-ci jusqu’à la création d’un nouveau réseau Party ou l’utilisation de certaines fonctionnalités de synthèse vocale ou de conversion de la parole en texte. La bibliothèque Party ne découvre pas automatiquement les régions disponibles et ne mesure pas la qualité de connexion à celles-ci, sauf si l’application appelle PartyManager::CreateNewNetwork() avec un tableau de liste de régions sans entrée, ou si, n’étant pas connectée à un réseau existant, elle appelle PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles(), PartyLocalChatControl::SetTextToSpeechProfile() ou PartyLocalChatControl::SetTranscriptionOptions() avec des indicateurs d’option incluant PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState. Une fois la découverte différée des régions et la mesure de qualité démarrées, un PartyRegionsChangedStateChange indiquant les régions disponibles ou le PartyStateChangeResult d’échec est fourni avant le changement d’état de fin de l’opération déclenchante : PartyCreateNewNetworkCompletedStateChange, PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange, PartySetTextToSpeechProfileCompletedStateChange ou PartySetTranscriptionOptionsCompletedStateChange. Lors des appels ultérieurs aux fonctions ci-dessus avec les paramètres décrits, la liste des régions est de nouveau récupérée et mesurée si l’intervalle d’actualisation s’est écoulé depuis les dernières mesures réussies. Si l’appareil est déjà connecté ou en cours de connexion à un réseau Party existant, l’actualisation est différée jusqu’à la déconnexion de tous les réseaux Party. L’intervalle d’actualisation peut être configuré à l’aide du champ refreshIntervalInSeconds de la structure PartyRegionUpdateConfiguration qui le contient. Les contrôles de clavardage utilisent en interne les estimations de latence des régions de l’appareil local pour optimiser l’utilisation du service pour la synthèse vocale, la transcription de la parole en texte et la traduction. L’utilisation de PartyRegionUpdateMode::Deferred peut entraîner une latence plus élevée pour ces fonctionnalités.

Configuration requise

En-tête : Party.h

Voir aussi

Membres de Party
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateConfiguration
PartyRegionsChangedStateChange
PartyCreateNewNetworkCompletedStateChange
PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange
PartySetTextToSpeechProfileCompletedStateChange
PartySetTranscriptionOptionsCompletedStateChange
PartyManager::Initialize
PartyManager::CreateNewNetwork
PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles
PartyLocalChatControl::SetTextToSpeechProfile
PartyLocalChatControl::SetTranscriptionOptions

XBOX Services

PlayFab

Syntaxe

Constantes

Configuration requise

Voir aussi

​Syntaxe

​Constantes

​Configuration requise

​Voir aussi

Syntaxe

Constantes

Configuration requise

Voir aussi