Méthode (1 sur 2)
Définit le jeton à utiliser pour l’authentification lors de l’exécution d’actions de la bibliothèque pour le compte d’une entité. Si un jeton a déjà été défini pour l’entité, celui-ci remplace le jeton précédent.Remarques (1 sur 2)
Cette méthode prend un PlayFabAuthenticationContextauthContext renvoyé par une méthode de connexion PlayFab. Lorsque la bibliothèque effectue, pour le compte d’une entité, des opérations qui nécessitent 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 été défini au préalable pour l’entité, l’opération échoue de manière synchrone. Pendant l’opération asynchrone, le service PlayFab vérifie que le jeton est valide, n’a pas expiré, est associé à l’ID d’entité fourni et 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 du résultat d’une opération de connexion PlayFab, puis fournis en entrée à cette méthode.
Le authContext fourni doit avoir été obtenu à l’aide du même ID de titre PlayFab que celui transmis à Initialize.
La bibliothèque Multiplayer 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 CreateAndJoinLobby. 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 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 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 Multiplayer en appelant de nouveau cette méthode. Il est recommandé 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.
Méthode (2 sur 2)
Définit le jeton à utiliser pour l’authentification lors de l’exécution d’actions de la bibliothèque pour le compte d’une entité. Si un jeton a déjà été défini pour l’entité, celui-ci remplace le jeton précédent.Remarques (2 sur 2)
Cette méthode prend une clé d’entité PlayFab comme localMember et un jeton d’entité PlayFab comme entityToken. Lorsque la bibliothèque effectue, pour le compte d’une entité, des opérations qui nécessitent 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 été défini au préalable pour l’entité, l’opération échoue de manière synchrone. Pendant l’opération asynchrone, le service PlayFab vérifie que le jeton est valide, n’a pas expiré, est associé à l’ID d’entité fourni et 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 du résultat d’une opération de connexion PlayFab, puis fournis en entrée à cette méthode. Les valeurs localMember et entityToken fournies doivent avoir été obtenues à l’aide du même ID de titre PlayFab que celui transmis àInitialize.
La bibliothèque Multiplayer 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 CreateAndJoinLobby. 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 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 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 Multiplayer en appelant de nouveau cette méthode. Il est recommandé 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.
Voir aussi
- méthode Initialize
- classe PFEntityKey
- classe PlayFabMultiplayer
- espace de noms PlayFab.Multiplayer