跳转到主要内容

排行榜快速入门

在本指南中,我们将了解如何为排行榜服务设置开发环境。我们还将学习如何从我们的网站 Game Manager 快速创建一个排行榜。

先决条件

我们需要一个 PlayFab 帐户才能使用 PlayFab 排行榜服务。有关创建帐户的说明,请参见身份验证

创建排行榜

在左侧菜单中选择 Progression。 PlayFab 排行榜主菜单 我们现在在上部菜单中选择 Leaderboards 选项卡。 PlayFab 排行榜 Game Manager 然后我们点击“New Leaderboard”按钮并创建我们的排行榜定义。 PlayFab 排行榜定义 在这里我们可以配置排行榜的每个方面。在此处了解可用参数以及如何创建排行榜的更多信息: 最终结果应该如下所示。 PlayFab 排行榜用法

设置环境

在这里我们将学习如何设置开发者环境以使用 C# SDK,但此处所介绍的概念也可以与其他 SDK 或普通 HTTP 请求一起使用。

设置 TitleId 和 DeveloperSecretKey

作为标题实体(Title Entity)进行身份验证时,需要 DeveloperSecretKey。

创建标题并获取密钥

  • 登录到 https://developer.playfab.com/
  • 创建一个标题
    • 在设置下的 API Features 部分找到 Title ID。
  • 生成密钥:
    • 点击标题视图左上方标题名称旁边的齿轮图标
    • Title Settings
    • Secret Keys
    • New secret key
以下是在 Game Manager 中找到 Secret Key 部分时的 UI 外观。 PlayFab 排行榜密钥

以标题身份登录

对于写入操作,我们建议从游戏服务器使用 TitleEntity,此方法将返回将在我们发出的所有请求中使用的 AuthenticationContext。

以玩家身份登录(创建玩家)

此方法基于一个标识符创建玩家,该标识符返回类型为 title_player_account 的实体。更多信息请见: 实体快速入门

为实体设置 display name 属性

为了让 DisplayName 属性作为 “Get Leaderboards APIs” 响应的一部分可用,我们需要对创建的每个实体执行以下代码,以便将实体映射到游戏的自定义显示名称。

另请参阅

最后修改于 2026年10月19日