跳轉到主要內容

排行榜快速入門

在本指南中,我們將了解如何為 Leaderboard 服務設定開發環境。我們也將 學習如何從我們的網站 Game Manager 快速建立排行榜。

必要條件

我們需要 PlayFab 帳戶才能使用 PlayFab Leaderboards 服務。如需建立帳戶的指示, 請參閱驗證

建立排行榜

我們將在左側功能表中選取 [Progression]。 PlayFab Leaderboards 主功能表 接著,我們從上方功能表選取 [Leaderboards] 索引標籤。 PlayFab Leaderboards Game Manager 然後我們將前往 [New Leaderboard] 按鈕,並建立我們的排行榜定義。 PlayFab Leaderboards 定義 在這裡,我們可以設定排行榜的每個面向。在此深入了解可用的參數以及 如何建立排行榜: 最終結果應如下所示。 PlayFab Leaderboards 使用方式

設定環境

在這裡,我們將學習如何設定開發人員環境以使用 C# SDK,但此處介紹的概念 也適用於其他 SDK 或一般的 HTTP 要求。

設定 TitleId 和 DeveloperSecretKey

以遊戲實體身分進行驗證時需要 DeveloperSecretKey。

建立遊戲並取得秘密金鑰

  • 登入 https://developer.playfab.com/
  • 建立遊戲
    • 在設定下的 [API Features] 區段中找到遊戲 ID。
  • 產生秘密金鑰:
    • 遊戲檢視左上角遊戲名稱旁的齒輪圖示
    • [Title Settings]
    • [Secret Keys]
    • [New secret key]
以下是您在 Game Manager 中找到 [Secret Key] 區段時,UI 的樣子。 PlayFab Leaderboards 金鑰

以遊戲身分登入

對於寫入作業,我們建議從您的遊戲伺服器使用 TitleEntity,此方法會傳回 AuthenticationContext, 它將用於我們發出的所有要求。

以玩家身分登入 (建立玩家)

此方法會根據識別碼建立玩家,並傳回類型為 title_player_account 的實體。詳細資訊請見: 實體快速入門

設定實體的顯示名稱屬性

為了讓 DisplayName 屬性能成為「Get Leaderboards API」回應的一部分, 我們需要為建立的每個實體執行下列程式碼,以便將實體對應至遊戲的自訂 顯示名稱。

另請參閱

最後修改於 2026年10月6日