PartyLocalUser::UpdateEntityToken

Aktualisiert das diesem lokalen Benutzer zugeordnete PlayFab-Entitätstoken zur Verwendung in zukünftigen authentifizierten Vorgängen.

Syntax

PartyError UpdateEntityToken(  
    PartyString entityToken  
)  

Parameter

entityToken PartyString

Das neue PlayFab-Entitätstoken, das dem lokalen Benutzer zugeordnet werden soll.

Rückgabewert

PartyError

c_partyErrorSuccess , wenn der Aufruf erfolgreich war oder andernfalls ein Fehlercode vorliegt. Die lesbare Form des Fehlercodes kann über PartyManager::GetErrorMessage() abgerufen werden.

Hinweise

Diese Methode akzeptiert ein PlayFab-Entitätstoken als entityToken. Für diesen Wert wird keine synchrone Überprüfung durchgeführt. Wenn die Bibliothek Vorgänge ausführt, die eine Benutzerauthentifizierung oder -autorisierung erfordern, z. B. das Erstellen eines Netzwerks, die Authentifizierung in einem Netzwerk oder die Spracherkennungstranskription, überprüft der Party-Dienst, ob das Token gültig ist, nicht abgelaufen ist, der gleichen Entitäts-ID zugeordnet ist, die für den Aufruf PartyManager::CreateLocalUser() oder PartyManager::CreateLocalUserWithEntityType() bereitgestellt wurde, und ist autorisiert, den Vorgang auszuführen. Wenn diese Bedingungen nicht erfüllt sind, schlägt der Vorgang fehl.

Ein PlayFab-Entitätstoken kann aus der Ausgabe eines PlayFab-Anmeldevorgangs abgerufen und dann als Eingabe für diese Methode bereitgestellt werden. Das Token muss der gleichen PlayFab-Entitäts-ID und demselben Typ zugeordnet sein, die ursprünglich für PartyManager::CreateLocalUser() oder PartyManager::CreateLocalUserWithEntityType() angegeben wurden.

Die bereitgestellte entityToken muss mit derselben Titel-ID abgerufen worden sein, die an PartyManager::Initialize() übergeben wurde.

Die Parteibibliothek erstellt eine Kopie des angegebenen PlayFab-Entitätstokens für die Verwendung in nachfolgenden Vorgängen, die eine Authentifizierung oder Autorisierung des lokalen Benutzers erfordern, z. B. PartyManager::CreateNewNetwork() oder PartyNetwork::AuthenticateLocalUser(). Wenn das für diesen Aufruf bereitgestellte Token abgelaufen oder anderweitig ungültig ist, schlagen Vorgänge, die ein gültiges Token erfordern, fehl. Ein neues, gültiges Token kann der Parteibibliothek durch einen anderen Aufruf dieser Methode bereitgestellt werden.

Der Aufrufer ist für die Überwachung des Ablaufs des Entitätstokens verantwortlich, das für diese Methode und PartyManager::CreateLocalUser() oder PartyManager::CreateLocalUserWithEntityType() bereitgestellt wird. Wenn das Token sich der Ablaufzeit nähert oder über diesen zeitraum herüberläuft, sollte ein neues Token abgerufen werden, indem ein PlayFab-Anmeldevorgang ausgeführt und der Parteibibliothek durch Aufrufen dieser Methode bereitgestellt wird. Es wird empfohlen, ein neues Token zu erwerben, wenn sich das zuvor bereitgestellte Token in der Hälfte seines Gültigkeitszeitraums befindet. Auf Plattformen, die möglicherweise in einen Energiesparzustand wechseln oder die Anwendung auf andere Weise dazu veranlassen, die Ausführung für einen längeren Zeitraum anzuhalten und zu verhindern, dass das Token aktualisiert wird, bevor es abläuft, sollte das Token auf Ablauf überprüft werden, sobald die Ausführung fortgesetzt wird.

Anforderungen

Kopfball: Party.h

Weitere Informationen

PartyLocalUser
PartyManager::GetErrorMessage
PartyManager::CreateLocalUser
PartyManager::CreateLocalUserWithEntityType
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser