方法(2 个方法中的第 1 个)
设置在代表某个实体执行库操作时应使用的身份验证令牌。如果先前已为该实体设置过令牌,此调用将替换其之前的令牌。备注(2 个中的第 1 个)
此方法接受一个由 PlayFab 登录方法返回的 PlayFabAuthenticationContextauthContext。当库代表实体执行需要身份验证或授权的操作时(例如创建或更新大厅),库将查找与该实体关联的令牌用于该操作。如果先前未为该实体设置任何令牌,则该操作将同步失败。在异步操作期间,PlayFab 服务将验证令牌是否有效、未过期、与所提供的 Entity ID 相关联,以及是否已获授权执行该操作。如果不满足这些条件,操作将失败。
PlayFab Entity Key 和 Entity Token 可从 PlayFab 登录操作的输出中获取,然后作为此方法的输入提供。
所提供的 authContext 必须使用与传递给 Initialize 相同的 PlayFab Title ID 获取。
Multiplayer 库会复制所提供的 PlayFab Entity Token,用于后续需要对本地用户进行身份验证或授权的操作(例如 CreateAndJoinLobby)。如果提供给此调用的令牌已过期或无效,则需要有效令牌的操作将失败。可以通过再次使用相同的实体密钥调用此方法,向 Multiplayer 库提供一个新的、有效的令牌。
调用方负责监视提供给此方法的实体令牌的过期时间。当令牌即将过期或已过期时,应通过执行 PlayFab 登录操作获取新令牌,并再次调用此方法将其提供给 Multiplayer 库。建议在先前提供的令牌达到其有效期的一半时获取新令牌。在可能进入低功耗状态或以其他方式使应用程序长时间暂停执行(从而无法在令牌过期之前刷新)的平台上,应在执行恢复后立即检查令牌是否过期。
方法(2 个方法中的第 2 个)
设置在代表某个实体执行库操作时应使用的身份验证令牌。如果先前已为该实体设置过令牌,此调用将替换其之前的令牌。备注(2 个中的第 2 个)
此方法接受 PlayFab Entity Key 作为 localMember、PlayFab Entity Token 作为 entityToken。当库代表实体执行需要身份验证或授权的操作时(例如创建或更新大厅),库将查找与该实体关联的令牌用于该操作。如果先前未为该实体设置任何令牌,则该操作将同步失败。在异步操作期间,PlayFab 服务将验证令牌是否有效、未过期、与所提供的 Entity ID 相关联,以及是否已获授权执行该操作。如果不满足这些条件,操作将失败。 PlayFab Entity Key 和 Entity Token 可从 PlayFab 登录操作的输出中获取,然后作为此方法的输入提供。 所提供的 localMember 和 entityToken 必须使用与传递给Initialize 相同的 PlayFab Title ID 获取。
Multiplayer 库会复制所提供的 PlayFab Entity Token,用于后续需要对本地用户进行身份验证或授权的操作(例如 CreateAndJoinLobby)。如果提供给此调用的令牌已过期或无效,则需要有效令牌的操作将失败。可以通过再次使用相同的实体密钥调用此方法,向 Multiplayer 库提供一个新的、有效的令牌。
调用方负责监视提供给此方法的实体令牌的过期时间。当令牌即将过期或已过期时,应通过执行 PlayFab 登录操作获取新令牌,并再次调用此方法将其提供给 Multiplayer 库。建议在先前提供的令牌达到其有效期的一半时获取新令牌。在可能进入低功耗状态或以其他方式使应用程序长时间暂停执行(从而无法在令牌过期之前刷新)的平台上,应在执行恢复后立即检查令牌是否过期。
另请参阅
- method Initialize
- class PFEntityKey
- class PlayFabMultiplayer
- namespace PlayFab.Multiplayer