> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 錦標賽與排行榜快速入門

> 舊版 PlayFab 錦標賽的快速入門：在 Game Manager 中建立 HighScore 統計資料與排行榜，然後使用 C# 從用戶端提交玩家分數。

# 錦標賽與排行榜快速入門

本快速入門說明如何建立可追蹤玩家最高分的統計資料，以及如何取得最高分排行榜。這可用於全域排行榜，或搭配[可重設的統計資料](/zh-TW/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards)針對特定活動或錦標賽進行重設。

## 必要條件

您的玩家已登入 PlayFab。

## 步驟 1 - 建立統計資料與相關聯的排行榜

在 Game Manager 中：

* 前往左側功能表中的 **Leaderboards**。
* 選取 **NEW LEADERBOARD**。
* 在 **Statistic name** 欄位中新增名為 **HighScore** 的 **Leaderboard**。
* 使用提供的下拉式功能表，將 **Reset frequency** 欄位設定為 **Manually**。
* 移至 **Aggregation method** 欄位，並從提供的下拉式功能表中選取 **Maximum** (一律使用最高值)。

## 步驟 2 - 以玩家的最高分更新統計資料

在從用戶端使用 [UpdatePlayerStatistics](xref:titleid.playfabapi.com.client.playerdatamanagement.updateplayerstatistics) 之前，我們必須在 **API Features** 中啟用它。

1. 從遊戲的 Settings 功能表中選取 **Title settings**。
2. 選取 **API Features** 索引標籤。
3. 核取 **Allow client to post player statistics** 方塊。
   注意：一般而言，不應在上線的遊戲中使用此選項，因為它會讓用戶端擁有所提交值的權限。這只適用於不擔心玩家可能竄改統計資料作弊的情況。如果統計資料必須安全，則只應透過伺服器授權的作業 (例如 Cloud Script 或自訂遊戲伺服器) 來更新。
4. 選取畫面底部的 **SAVE**。

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/tournaments-leaderboards/tutorials/api-features-allow-client-to-post-player-statistics.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=71197d724d092da6b5ff0a4093ad843e" alt="Game Manager - 設定 - API 功能 - 允許用戶端張貼玩家統計資料" width="2079" height="1191" data-path="images/playfab/community/leaderboards/tournaments-leaderboards/tutorials/api-features-allow-client-to-post-player-statistics.png" />

### C# 程式碼範例 - SubmitScore

在此程式碼範例中，我們會有一個在遊戲結束時呼叫的 `SubmitScore` 函式。

```csharp theme={null}

public void SubmitScore(int playerScore) {
    PlayFabClientAPI.UpdatePlayerStatistics(new UpdatePlayerStatisticsRequest {
        Statistics = new List<StatisticUpdate> {
            new StatisticUpdate {
                StatisticName = "HighScore",
                Value = playerScore
            }
        }
    }, result=> OnStatisticsUpdated(result), FailureCallback);
}

private void OnStatisticsUpdated(UpdatePlayerStatisticsResult updateResult) {
    Debug.Log("Successfully submitted high score");
}

private void FailureCallback(PlayFabError error){
    Debug.LogWarning("Something went wrong with your API call. Here's some debug information:");
    Debug.LogError(error.GenerateErrorReport());
}
```

### 步驟 3 - 要求最高分的排行榜

若要取得所有玩過遊戲之玩家的最高分排行榜，您需要呼叫 [GetLeaderboard](xref:titleid.playfabapi.com.client.playerdatamanagement.getleaderboard)。

### C# 程式碼範例 - RequestLeaderboard

在此程式碼範例中，我們會有一個用來取得排行榜的 `RequestLeaderboard` 函式，它會將結果傳遞給 `DisplayLeaderboard` 函式，由該函式填入遊戲中顯示最高分的體驗。

```csharp theme={null}
//Get the players with the top 10 high scores in the game
public void RequestLeaderboard() {
    PlayFabClientAPI.GetLeaderboard(new GetLeaderboardRequest {
            StatisticName = "HighScore",
            StartPosition = 0,
            MaxResultsCount = 10
    }, result=> DisplayLeaderboard(result), FailureCallback);
}

private void FailureCallback(PlayFabError error){
    Debug.LogWarning("Something went wrong with your API call. Here's some debug information:");
    Debug.LogError(error.GenerateErrorReport());
}
```


## Related topics

- [錦標賽與排行榜](/zh-TW/services/playfab/community/leaderboards/tournaments-leaderboards/index.md)
- [排行榜快速入門](/zh-TW/services/playfab/community/leaderboards/quickstart-leaderboards.md)
- [推播通知快速入門](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart.md)
- [存取已封存的錦標賽結果](/zh-TW/services/playfab/community/leaderboards/tournaments-leaderboards/accessing-archived-tournament-results.md)
- [動作與規則快速入門](/zh-TW/services/playfab/data-analytics/acting-data/action-rules-quickstart.md)