虚幻引擎5文档已被迁移至 Epic开发者社区

连接到游戏会话并通过互联网与其他玩家进行交互通常需要登录一个在第三方在线服务上注册的账户。 这些服务可被社交媒体站点、硬件平台拥有者或游戏服务运行。 在虚幻引擎4中， 身份接口 负责处理与这些服务账户相关的交互，并提供验证使用者以及获取访问令牌的功能。

验证函数

登录

Login 函数获取本地玩家的账户登录信息（ FOnlineAccountCredentials ）并尝试登入在线服务。 如需自动生成账户登录信息（或通过命令行参数生成），可转而调用 AutoLogin 。 在线服务响应后，无论登录尝试成功与否， FOnLoginCompleteDelegate 均会被调用。 此外，特定本地玩家的登录状态改变时均会调用 FOnLoginStatusChangedDelegate 。

登出

如需让用户登出在线服务，则使用 Logout 函数。 操作完成后将调用 FOnLogoutCompleteDelegate 。 此外，特定本地用户的登录状态发生变化时将调用 FOnLoginStatusChangedDelegate 。

检查当前登录状态

本地玩家可以登入在线、登入本地配置（但未在线），或完全不登入。 为找到玩家当前的状态，请使用 GetLoginStatus 函数。 登入状态基于与在线服务最近的通信而定，因此没有要绑定的委托。 如果正在等待特定状态发生变化（如玩家登入），则请勿定期轮询此函数，绑定 FOnLoginStatusChangedDelegate 将有所帮助。

玩家身份与信息

在身份系统之间转换

在虚幻引擎4的网络连接环境中，登录尝试成功后一个不透明的 FUniqueNetId 值将自动与一个本地玩家关联。 除在虚幻引擎4的网络连接代码中使用外，其也将作为每种在线服务专属身份数据类型的抽象物。

身份接口拥有数个函数，可在各种系统和身份类型之间进行连接。 获取玩家 FUniqueNetId 的方法有两种：随该玩家的服务专属身份调用 CreateUniquePlayerId ，或随玩家的本地使用者索引调用 GetUniquePlayerId 。 使用玩家的 FUniqueNetId 调用 GetPlatformUserIdFromUniqueNetId 来获取玩家服务专属的身份（类型为 FPlatformUserId ），但这在多数情况下均不需要。 所有这些函数均使用本地可用的信息，因此不涉及委托或回调。

使用者账户信息

抽象类 FOnlineUser 代表任意在线子系统相关用户账户的基础信息，并用作访问本地或远程使用者公开可见信息的通用接口。 借助此类的延展 FUserOnlineAccount 能够访问本地已登入使用者的所有可用信息。

在部分情况下，可对在线系统的 FOnlineUser 子类进行延展，满足特定在线服务的需求。 基类支持返回用户 FUniqueNetId 、真实和显示名称（基于所使用的在线服务），以及可能与使用者相关的所有基于字符串的属性。但这些属性的保存必须在子类中实现。

FUserOnlineAccount 类同样为抽象，但她将建立一个框架，设置使用者属性并保存本地已登入使用者的元数据（包括服务专属访问令牌或其他数据）。 部分子系统使用这些令牌来访问功能，可将其用于进行RESTful调用，或与自有的后端服务进行协调。

获取本地已知账户

多种在线服务均能追踪从本地机上登入（或在本地机上创建）的使用者账户。 对执行此操作的本地服务而言，实现 GetAllUserAccounts 函数将返回这些所有已知账户的排列列表。 这些账户将被返回为 FUserOnlineAccount 数据。 如需查看特定玩家是否在列表上，可调用 GetUserAccount 将玩家 FUniqueNetId 映射到一个已知的 FUserOnlineAccount （如列表中存在）。

玩家显示名

部分在线服务允许使用者输入与其账户登录名不同的"显示名"或"昵称"。 在游戏聊天、计分板、角色标签或相似的使用者显示中，此名称的使用优先级高于账户名。 使用玩家的 FOnlineUser ，调用 GetDisplayName 从本地缓存的用户账户数据中获取该玩家的显示名或昵称。

使用者权限

在线服务可用作一个门户，同意或阻止对特定在线功能的访问，而其最重要的功能便是让在线使用者进行在线游戏。 GetUserPrivilege 函数将报告一个使用者是否拥有特定权限（在[`EUserPrivileges`]中定义(https://api.unrealengine.com/INT/API/Plugins/OnlineSubsystem/Interfaces/EUserPrivileges__Type/index.html)）。 此函数需要连接在线服务，将通过 FOnGetUserPrivilegeCompleteDelegate 响应使用者请求，返回一个 EPrivilegeResults 类型的结果。