通过

PartyLocalUser::UpdateEntityToken

  • 项目

更新与此本地用户关联的 PlayFab 实体令牌，以便在将来经过身份验证的操作中使用。

语法

PartyError UpdateEntityToken(  
    PartyString entityToken  
)

参数

entityToken PartyString

要与本地用户关联的新 PlayFab 实体令牌。

返回值

PartyError

如果调用成功，则为 c_partyErrorSuccess，否则为错误代码。 可通过 PartyManager::GetErrorMessage() 检索错误代码的可读形式。

备注

此方法采用 PlayFab 实体令牌作为 entityToken。 不对此值执行同步验证。 当库执行需要用户身份验证或授权的操作（例如创建网络、向网络进行身份验证或执行语音转文本听录）时，Party 服务将验证令牌是否有效、未过期，是否与提供给 PartyManager：：CreateLocalUser () 或 PartyManager：：CreateLocalUserWithEntityType () 调用的相同实体 ID 相关联， 和 有权执行操作。 如果不满足这些条件，操作将失败。

可以从 PlayFab 登录操作的输出中获取 PlayFab 实体令牌，然后将其作为输入提供给此方法。 令牌必须与最初指定给 PartyManager：：CreateLocalUser () 或 PartyManager：：CreateLocalUserWithEntityType () 相同的 PlayFab 实体 ID 和类型相关联。

必须使用传递给 PartyManager：：Initialize（）的相同游戏 ID 获取提供的entityToken。

参与方库创建提供的 PlayFab 实体令牌的副本，以便在需要对本地用户进行身份验证或授权的后续操作中使用，例如 PartyManager：：CreateNewNetwork（） 或 PartyNetwork：：AuthenticateLocalUser（）。 如果向此调用提供的令牌过期或无效，则需要有效令牌的操作将失败。 通过另一个对此方法的调用，可以向 Party 库提供新的有效令牌。

调用方负责监视提供给此方法的实体令牌和 PartyManager：：CreateLocalUser () 或 PartyManager：：CreateLocalUserWithEntityType () 的过期时间。 当令牌接近或超过过期时间时，应通过执行 PlayFab 登录操作获取新令牌，并通过调用此方法提供给 Party 库。 建议在以前提供的令牌在其有效期过半时获取新令牌。 平台在可能会进入低性能状态或导致应用程序长时间暂停执行，从而阻止在到期之前刷新令牌，应该在恢复执行时检查令牌是否过期。

要求

标题： Party.h

另请参阅

PartyLocalUser
PartyManager：：GetErrorMessage
PartyManager::CreateLocalUser
PartyManager：：CreateLocalUserWithEntityType
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser