PartyRegionsChangedStateChange
Spezifische Informationen für den RegionsChanged-Zustandsänderungstyp.
Syntax
struct PartyRegionsChangedStateChange : PartyStateChange {
PartyStateChangeResult result;
PartyError errorDetail;
}
Mitglieder
result
PartyStateChangeResult
Gibt an, ob ein Hintergrundvorgang zum Abfragen der Liste der unterstützten Regionen und der Latenz für jede Region erfolgreich war, oder gibt den Grund für den Fehler an.
Wenn das Ergebnis PartyStateChangeResult::Succeeded lautet, wird die von PartyManager::GetRegions() bereitgestellte Regionsliste mit den Ergebnissen des Vorgangs aufgefüllt. Bei einem Fehler ist die von PartyManager::GetRegions() bereitgestellte Regionsliste leer.
Wenn das Ergebnis PartyStateChangeResult::FailedToBindToLocalUdpSocket lautet, konnte die Bibliothek nicht an den lokalen UDP-Socket gebunden werden, der in der Option PartyOption::LocalUdpSocketBindAddress angegeben ist. Der Titel muss seine instance der Bibliothek sauber, die Option PartyOption::LocalUdpSocketBindAddress auf eine gültige, verfügbare Bindungsadresse aktualisieren und die Bibliothek erneut initialisieren.
errorDetail PartyError
Ein Diagnosewert, der weitere Informationen zur Problembehandlung für mögliche Fehlerzustände bereitstellt.
Die lesbare Form dieses Fehlerdetails kann über PartyManager::GetErrorMessage() abgerufen werden.
Hinweise
Das Abrufen der Liste der verfügbaren Regionen und das Messen der Verbindungsqualität für diese Regionen erfolgt automatisch im Hintergrund. Dieser Vorgang wird zuerst initiiert, wenn PartyManager::Initialize() aufgerufen wird, es sei denn, die Option PartyOption::RegionUpdateConfiguration wurde verwendet, um einen Updatemodus von PartyRegionUpdateMode::D eferred zu konfigurieren. In diesem Fall werden Regionsupdates möglicherweise gar nicht durchgeführt. Verzögerte Regionsupdates treten nur auf, wenn die Anwendung PartyManager::CreateNewNetwork() mit einem Nulleingabebereichsarray aufruft. oder ist nicht mit einem vorhandenen Netzwerk verbunden, ruft aber PartyLocalChatControl::P opulateAvailableTextToSpeechProfiles(), PartyLocalChatControl::SetTextToSpeechProfile() oder PartyLocalChatControl::SetTranscriptionOptions() mit Optionsflags auf, die PartyVoiceChatTranscriptionOptions:: TranscribeSelfRegardlessOfNetworkState. Die Option PartyOption::RegionUpdateConfiguration kann auch verwendet werden, um das Intervall zu konfigurieren, nach dem die Regionen aktualisiert werden.
Die Zeit, die benötigt wird, um die Liste der verfügbaren Regionen abzurufen und die Verbindungsqualität für diese zu messen, hängt von vielen Umgebungs- oder dynamischen Faktoren ab und davon, ob die Option PartyOption::RegionQualityMeasurementConfiguration verwendet wurde, um Die Einstellungen für Die Messung auf niedriger Ebene zu ändern. Das Feld totalMeasurementTimeoutInMilliseconds in der Struktur PartyRegionQualityMeasurementConfiguration wird verwendet, um das maximale Timeout im ungünstigsten Fall zu konfigurieren, bevor alle Messungen als abgeschlossen betrachtet und diese Zustandsänderung generiert wird.
Voraussetzungen
Header: Party.h