PartyRegionUpdateConfiguration
Die Konfiguration, die von der Parteibibliothek verwendet wird, um zu steuern, wie automatische Regionsermittlungs- und Verbindungsqualitätsmessungen durchgeführt werden.
Syntax
struct PartyRegionUpdateConfiguration {
PartyRegionUpdateMode mode;
uint32_t refreshIntervalInSeconds;
}
Mitglieder
Der Modus, der steuert, wann Die Regionsermittlung und die Verbindungsqualitätsmessung aktualisiert werden.
Der Standardwert ist PartyRegionUpdateMode::Immediate , wenn PartyOption::RegionUpdateConfiguration nicht konfiguriert wurde.
refreshIntervalInSeconds uint32_t
Die Anzahl der Sekunden, die nach Abschluss der Regionsqualitätsmessungen verstreichen dürfen, bevor ein neuer Prozess zur Ermittlung der Region und zur Messung der Verbindungsqualität beginnen kann.
Dieses Aktualisierungsintervall wird immer dann verwendet, wenn ein PartyRegionsChangedStateChange bereitgestellt wird, um zu bestimmen, wann die nächste Regionsqualitätsmessung unter dem durch das Modusfeld definierten Updatemodus gestartet werden kann.
Wenn Sie für eine Aktualisierung berechtigt sind, kann nicht garantiert werden, dass die Aktualisierung genau zu diesem Zeitpunkt beginnt. Wenn das Modusfeld auf PartyRegionUpdateMode::D eferred festgelegt ist, erfolgt die nächste Aktualisierung erst, wenn eine der anwendbaren Methoden aufgerufen wird, um eine Regionsaktualisierung auszulösen. Die Bibliothek wartet auch, bis sich das lokale Gerät nicht mehr in Partynetzwerken befindet, und wendet eine kleine zufällige Verzögerung an, um die Auslastung des PlayFab-Diensts von mehreren, unbeabsichtigt synchronisierten Geräten zu vermeiden.
Der Standardwert ist 28800 (8 Stunden), wenn PartyOption::RegionUpdateConfiguration nicht konfiguriert wurde.
Der Wert 0 (null) bewirkt, dass die Parteibibliothek Die Messungen in Zukunft nie automatisch aktualisiert. Andernfalls beträgt der minimal zulässige Wert 30 Sekunden.
Hinweise
Diese Struktur kann zusammen mit PartyOption::RegionUpdateConfiguration verwendet werden, um die aktuelle Konfiguration der Parteibibliothek über PartyManager::SetOption() bzw . PartyManager::GetOption() zu überschreiben oder abzufragen. Es konfiguriert das Verhalten der Regionsermittlung und des Prozesses zur Messung der Verbindungsqualität, der PartyRegionsChangedStateChange-Zustandsänderungen erzeugt.
Voraussetzungen
Header: Party.h
Weitere Informationen
Party-Mitglieder
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateMode
PartyRegionsChangedStateChange
PartyManager::SetOption
PartyManager::GetOption