Syntaxe
Membres
result PartyStateChangeResult
Indique si une opération en arrière-plan visant à interroger la liste des régions prises en charge et la latence vers chaque région a réussi, ou fournit la raison de son échec.
Lorsque le résultat est PartyStateChangeResult::Succeeded, la liste des régions fournie par PartyManager::GetRegions() est remplie avec les résultats de l’opération. En cas d’échec, la liste des régions fournie par PartyManager::GetRegions() est vide. Si le résultat est PartyStateChangeResult::FailedToBindToLocalUdpSocket, la bibliothèque n’a pas pu se lier au socket UDP local spécifié dans l’option PartyOption::LocalUdpSocketBindAddress. Le titre doit nettoyer son instance de la bibliothèque, mettre à jour l’option PartyOption::LocalUdpSocketBindAddress avec une adresse de liaison valide et disponible, puis réinitialiser la bibliothèque.
errorDetail PartyError
Valeur de diagnostic fournissant des informations de dépannage supplémentaires sur toute condition d’erreur potentielle.
La forme lisible de ce détail d’erreur peut être obtenue au moyen de PartyManager::GetErrorMessage().
Remarques
La récupération de la liste des régions disponibles et la mesure de la qualité de connexion vers celles-ci se produisent automatiquement en arrière-plan. Cette opération est lancée pour la première fois lorsque PartyManager::Initialize() est appelé, sauf si l’option PartyOption::RegionUpdateConfiguration a été utilisée pour configurer un mode de mise à jour PartyRegionUpdateMode::Deferred, auquel cas les mises à jour des régions peuvent ne jamais se produire. Les mises à jour différées des régions ne se produisent que si l’application appelle PartyManager::CreateNewNetwork() avec un tableau de régions vide, ou si elle n’est pas connectée à un réseau existant mais appelle PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles(), PartyLocalChatControl::SetTextToSpeechProfile() ou PartyLocalChatControl::SetTranscriptionOptions() avec des indicateurs d’option incluant PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState. L’option PartyOption::RegionUpdateConfiguration peut également être utilisée pour configurer l’intervalle après lequel les régions sont actualisées.Le temps nécessaire pour récupérer la liste des régions disponibles et mesurer la qualité de connexion vers celles-ci dépend de nombreux facteurs environnementaux ou dynamiques, et du fait que l’option PartyOption::RegionQualityMeasurementConfiguration ait été utilisée ou non pour modifier les paramètres de mesure de bas niveau. Le champ totalMeasurementTimeoutInMilliseconds de la structure PartyRegionQualityMeasurementConfiguration permet de configurer le délai d’expiration maximal dans le pire des cas avant que toutes les mesures soient considérées comme terminées et que ce changement d’état soit généré.
Configuration requise
En-tête : Party.hVoir aussi
Membres de PartyPartyManager::GetRegions