跳轉到主要內容
在本教學課程中,您將了解如何使用 Cloudscript 實作排行榜,具體來說是透過 Azure Functions。 這種方法很強大,因為它可讓您建立自訂的伺服器端邏輯,而不需要更新用戶端。 在 Azure 函式中定義與排行榜相關的邏輯後,您的用戶端就可以叫用該函式來執行程式碼。如果之後需要變更,您可以獨立更新 Azure 函式,視更新的複雜度而定,通常不需要修改用戶端。

必要條件

若要依照本教學課程操作,您需要:
  • PlayFab 帳戶。如果您沒有帳戶,可以在這裡建立。
  • Azure 訂用帳戶。如果您沒有訂用帳戶,可以在這裡建立。
如需如何建立 Azure 函式的詳細資訊,請參閱此指南。使用 Visual Studio 在 Azure 中建立您的第一個函式

使用 Azure Functions 建立排行榜

在本節中,我們將建立一個排行榜,可讓您提交分數並擷取最高分數。
  • 此函式屬性 [Function("LeaderboardExample")] 定義函式的名稱,在此案例中為 LeaderboardExample。
  • 此函式由 HTTP 要求觸發,如 [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] 屬性所示。這表示無需任何驗證,即可透過 HTTP GET 和 POST 方法存取此函式。
  • 在函式中,我們設定 PlayFab 遊戲 ID 和開發人員秘密金鑰,以驗證我們對 PlayFab 服務的要求。您可以根據最適合您特定案例和安全性需求的方式,變更存取這些值的方法。
  • 此函式會檢查要求中是否提供查詢參數 “leaderboardName”。
  • 接著我們呼叫 LoginAsTitleEntity 方法,以遊戲實體身分進行驗證,這是建立排行榜定義所必需的。
  • 最後,我們呼叫 CreateLeaderboardDefinitionAsync 方法,以提供的名稱建立排行榜定義。若要深入了解排行榜的建立,您可以參閱建立基本排行榜和使用排行榜執行更多操作。
RunAsync 方法是您 Azure 函式的進入點。從這裡,您可以定義並呼叫其他方法來建置您的自訂遊戲邏輯。如何處理錯誤或與多個 PlayFab 服務互動完全由您決定,讓您在實作上擁有完全的彈性。 此外,您可以設定自動化規則,根據特定事件觸發此 Azure 函式。如需詳細資訊,請參閱這裡。

另請參閱

最後修改於 2026年10月6日