Syntaxe
Paramètres
handle PFMultiplayerHandle
Handle de l’instance de l’API PFMultiplayer.
entity PFEntityKey*
Clé d’entité PlayFab à associer à un jeton.
entityToken char*se termine par un caractère null TBD
Valeur de retour
Type : HRESULTS_OK si la création de l’utilisateur local a réussi, ou un code d’erreur dans le cas contraire. La forme lisible du code d’erreur peut être récupérée au moyen de PFMultiplayerGetErrorMessage().
Remarques
Cette méthode prend une clé d’entité PlayFab commeentity et un jeton d’entité PlayFab comme token. Lorsque la bibliothèque effectue, pour le compte d’une entité, des opérations nécessitant une authentification ou une autorisation, comme la création ou la mise à jour d’un lobby, elle recherche un jeton associé à l’entité à utiliser pour l’opération. Si aucun jeton n’a encore été défini pour l’entité, l’opération échoue de façon synchrone. Pendant l’opération asynchrone, le service PlayFab vérifie que le jeton est valide, qu’il n’a pas expiré, qu’il est associé à l’ID d’entité fourni et qu’il est autorisé à effectuer l’opération. Si ces conditions ne sont pas remplies, l’opération échoue. Une clé d’entité et un jeton d’entité PlayFab peuvent être obtenus à partir de la sortie d’une opération de connexion PlayFab, puis fournis en entrée de cette méthode.
Les
entity et token fournis doivent avoir été obtenus à l’aide du même Title ID PlayFab que celui transmis à PFMultiplayerInitialize(). La bibliothèque Multiplayer effectue une copie du jeton d’entité PlayFab fourni pour l’utiliser dans les opérations ultérieures nécessitant l’authentification ou l’autorisation de l’utilisateur local, comme
PFMultiplayerCreateAndJoinLobby. Si le jeton fourni à cet appel a expiré ou n’est pas valide, les opérations nécessitant un jeton valide échouent. Un nouveau jeton valide peut être fourni à la bibliothèque Multiplayer en appelant de nouveau cette méthode avec la même clé d’entité. Il incombe à l’appelant de surveiller l’expiration du jeton d’entité fourni à cette méthode. Lorsque le jeton approche de sa date d’expiration ou l’a dépassée, un nouveau jeton doit être obtenu en effectuant une opération de connexion PlayFab, puis fourni à la bibliothèque Multiplayer en appelant de nouveau cette méthode. Il est recommandé d’obtenir un nouveau jeton lorsque le jeton précédemment fourni a atteint la moitié de sa période de validité. Sur les plateformes susceptibles de passer en mode basse consommation ou de suspendre l’exécution de l’application pendant une longue période, empêchant l’actualisation du jeton avant son expiration, il convient de vérifier l’expiration du jeton dès la reprise de l’exécution.
Aucune validation synchrone n’est effectuée sur ces valeurs.
Configuration requise
En-tête : PFMultiplayer.hVoir aussi
Membres de PFMultiplayerPFMultiplayerInitialize