Syntaxe
Paramètres
entityToken PartyString
Le nouveau jeton d’entité PlayFab à associer à l’utilisateur local.
Valeur de retour
PartyErrorc_partyErrorSuccess si l’appel a réussi; sinon, un code d’erreur. La forme lisible du code d’erreur peut être obtenue au moyen de PartyManager::GetErrorMessage().
Remarques
Cette méthode prend un jeton d’entité PlayFab commeentityToken. Aucune validation synchrone n’est effectuée sur cette valeur. Lorsque la bibliothèque effectue des opérations nécessitant l’authentification ou l’autorisation de l’utilisateur, comme la création d’un réseau, l’authentification dans un réseau ou la transcription de la parole en texte, le service Party vérifie que le jeton est valide, n’a pas expiré, est associé au même ID d’entité que celui fourni lors de l’appel à PartyManager::CreateLocalUser() ou PartyManager::CreateLocalUserWithEntityType(), et est autorisé à effectuer l’opération. Si ces conditions ne sont pas remplies, l’opération échoue. Un jeton d’entité PlayFab peut être obtenu à partir du résultat d’une opération de connexion PlayFab, puis fourni en entrée à cette méthode. Le jeton doit être associé au même ID et au même type d’entité PlayFab que ceux spécifiés à l’origine à PartyManager::CreateLocalUser() ou PartyManager::CreateLocalUserWithEntityType().
Le
entityToken fourni doit avoir été obtenu à l’aide du même ID de titre que celui transmis à PartyManager::Initialize(). La bibliothèque Party effectue une copie du jeton d’entité PlayFab fourni pour l’utiliser dans les opérations ultérieures qui nécessitent l’authentification ou l’autorisation de l’utilisateur local, comme PartyManager::CreateNewNetwork() ou PartyNetwork::AuthenticateLocalUser(). Si le jeton fourni à cet appel a expiré ou n’est pas valide pour une autre raison, les opérations qui nécessitent un jeton valide échouent. Un nouveau jeton valide peut être fourni à la bibliothèque Party par un autre appel à cette méthode.
Il incombe à l’appelant de surveiller l’expiration du jeton d’entité fourni à cette méthode et à PartyManager::CreateLocalUser() ou PartyManager::CreateLocalUserWithEntityType(). Lorsque le jeton approche de son heure 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 Party en appelant cette méthode. Nous recommandons d’obtenir un nouveau jeton lorsque le jeton fourni précédemment 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 ainsi l’actualisation du jeton avant son expiration, l’expiration du jeton doit être vérifiée dès la reprise de l’exécution.
Configuration requise
En-tête : Party.hVoir aussi
PartyLocalUserPartyManager::GetErrorMessage
PartyManager::CreateLocalUser
PartyManager::CreateLocalUserWithEntityType
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser