PFMultiplayerSetEntityToken
Legt das Token fest, das für die Authentifizierung verwendet werden soll, wenn Bibliotheksaktionen im Namen einer Entität ausgeführt werden. Wenn zuvor ein Token für die Entität festgelegt wurde, wird das vorherige Token ersetzt.
Syntax
HRESULT PFMultiplayerSetEntityToken(
PFMultiplayerHandle handle,
const PFEntityKey* entity,
const char* entityToken
)
Parameter
handle PFMultiplayerHandle
Das Handle der PFMultiplayer-API instance.
entity
PFEntityKey*
Der PlayFab-Entitätsschlüssel, der einem Token zugeordnet werden soll.
entityToken Char*
ist NULL-terminiert.
TBD
Rückgabewert
Typ: HRESULT
S_OK , wenn das Erstellen des lokalen Benutzers erfolgreich war, andernfalls ein Fehlercode. Die lesbare Form des Fehlercodes kann über PFMultiplayerGetErrorMessage() abgerufen werden.
Hinweise
Diese Methode verwendet einen PlayFab-Entitätsschlüssel als entity und ein PlayFab-Entitätstoken als token. Wenn die Bibliothek Vorgänge im Namen einer Entität ausführt, die eine Authentifizierung oder Autorisierung erfordern, z. B. das Erstellen oder Aktualisieren eines Wartebereichs, sucht die Bibliothek nach einem Token, das der Entität zugeordnet ist, die für den Vorgang verwendet werden soll. Wenn zuvor kein Token für die Entität festgelegt wurde, schlägt der Vorgang synchron fehl. Während des asynchronen Vorgangs überprüft der PlayFab-Dienst, ob das Token gültig ist, nicht abgelaufen ist, der bereitgestellten Entitäts-ID zugeordnet ist und zum Ausführen des Vorgangs autorisiert ist. Wenn diese Bedingungen nicht erfüllt sind, schlägt der Vorgang fehl.
Ein PlayFab-Entitätsschlüssel und ein Entitätstoken können aus der Ausgabe eines PlayFab-Anmeldevorgangs abgerufen und dann als Eingabe für diese Methode bereitgestellt werden.
Die bereitgestellten entity und token müssen mit derselben PlayFab-Titel-ID abgerufen worden sein, die an PFMultiplayerInitialize() übergeben wurde.
Die Multiplayerbibliothek 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 PFMultiplayerCreateAndJoinLobby. B. . 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 für die Multiplayerbibliothek bereitgestellt werden, indem diese Methode erneut mit demselben Entitätsschlüssel aufgerufen wird.
Der Aufrufer ist für die Überwachung des Ablaufs des Entitätstokens verantwortlich, das für diese Methode bereitgestellt wird. Wenn sich das Token nähert oder die Ablaufzeit übergibt, sollte ein neues Token abgerufen werden, indem ein PlayFab-Anmeldevorgang ausgeführt und der Multiplayer-Bibliothek bereitgestellt wird, indem diese Methode erneut aufgerufen wird. Es wird empfohlen, ein neues Token abzurufen, wenn das zuvor bereitgestellte Token die Hälfte seines Gültigkeitszeitraums durchläuft. 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.
Für diese Werte wird keine synchrone Überprüfung durchgeführt.
Voraussetzungen
Header: PFMultiplayer.h