Skip to main content
使用 PlayFab 时,你通常使用以下 API 方法构建排行榜: 结果是一个 PlayerLeaderboardEntry 对象列表,其中仅包含关于玩家及其与当前排行榜的关系的基本信息。 但是,PlayFab 还允许你使用 PlayerProfileViewConstraints,以获取每个玩家的其他信息。
此示例假定你已经有一些排行榜数据可以使用。请参阅我们的访问已存档的锦标赛结果教程,了解生成一些测试数据的方法。

配置玩家配置文件视图约束

默认情况下,Client API 只能从另一个玩家配置文件获取显示名称。在此示例中,我们将允许所有玩家访问关于排行榜中其他玩家的其他信息。 导航到你的标题 Game Manager:
  1. 选择左侧菜单中的 Settings 图标。
  2. 选择 Title settings
  3. 然后选择 Client Profile Options 选项卡。
  4. 确认已选择 DisplayName
  5. 确保已选择 Avatar URL
  6. 通过选择 Save Client Profile Options 按钮提交更改。
Game Manager - Settings - Client Profile Options

测试

上一步允许客户端代码使用 DisplayNameAvatarUrl 配置文件约束。 以下示例演示如何使用提到的任何配置文件数据获取和打印排行榜。请参阅代码注释以获取更多信息。
各个配置文件字段在客户端使用配置文件约束显式请求时可用。另请注意,如果 Game Manager 中允许某些配置文件约束——而你的客户端请求它们——API 调用将失败,并返回相应的错误。结果将类似于下面提供的示例。
Output - Display Leaderboard 使用此技术,你可以获取一些配置文件信息,包括其他统计信息值。
最后修改于 2026年8月13日