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

排行榜记录游戏的最高分，鼓励玩家与好友和其他玩家进行竞争。 游戏可以拥有奖分的多个模式，每个模式均可拥有自身的排行榜。 计分模式可从最高到最低进行排行（传统积分制游戏），或从最低到最高（如计时或竞赛游戏）。 排行榜接口为开发者提供了各种必要工具，以便在游戏中显示和更新排行榜。

计分方法

定义排行榜处理积分的方式有3个不同方面，每个方面均在列举类型中定义。

• ELeaderboardSort 指定是否对积分进行排序，如要，则决定升序或降序。

• ELeaderboardFormat 控制格式调整。 积分可以是原始数（点数）或时间（秒或毫秒）。

• ELeaderboardUpdateMethod 说明排行榜是保持玩家最近的分数，还是玩家的最高分数（基于排序方法）。

获取排行榜数据

排行榜数据可能非常之大，因为每个已进行游戏的使用者账户所支持的每个排行榜中均可能有一个条目。 因此，获取将以文件块的形式完成，游戏可以几个不同方式来获取排行榜的部分。 获取排行榜数据的所有方法都将接收一个类型为 FOnlineLeaderboardRead （参见 FOnlineLeaderboardRead 了解相关的数据类型）的参数（保存需要在线服务发送回的表格定义），并调用一个带 布尔 的委托（类型为 FOnLeaderboardReadComplete ），在完成时说明成功或失败。 支持以下查询选项：

上传排行榜数据

如要写入单个玩家的得分，使用 WriteLeaderboards 来缓存更新（类型为 FOnlineLeaderboardWrite ），其之后将被传输至在线服务。 每个 FOnlineLeaderboardWrite 对象均与一个会话命名和一个玩家（由 FUniqueNetId 识别）相关联。 当游戏已准备好将会话数据提交到在线服务的记录时， FlushLeaderboards 将发送缓存数据并将其从本地系统中清除，并在完成时调用在线子系统的 OnLeaderboardFlushComplete 委托。