Skip to main content
在本教程中,您将学习如何使用 Cloudscript(特别是通过 Azure Functions)实现排行榜。此方法很强大,因为它使您能够创建自定义服务器端逻辑,而无需更新客户端。 通过在 Azure Function 中定义与排行榜相关的逻辑,您的客户端可以调用该函数来执行代码。如果以后需要更改,您可以独立更新 Azure Function — 通常无需修改客户端,具体取决于更新的复杂性。

先决条件

若要按照本教程操作,您需要:
  • PlayFab 账户。如果您没有账户,可以在此处创建。
  • Azure 订阅。如果您没有订阅,可以在此处创建。
有关如何创建 Azure Function 的更多详细信息,请参阅此指南。使用 Visual Studio 在 Azure 中创建你的第一个函数

使用 Azure Functions 创建排行榜

在本节中,我们将创建一个允许您提交分数并检索最高分数的排行榜。
  • 此函数特性 [Function("LeaderboardExample")] 定义了函数的名称,在此情况下为 LeaderboardExample
  • 该函数由 HTTP 请求触发,如 [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] 特性所示。这意味着可以通过 HTTP GET 和 POST 方法访问该函数,无需任何身份验证。
  • 在该函数内,我们设置 PlayFab Title ID 和 Developer Secret Key,以对我们向 PlayFab 服务发出的请求进行身份验证。您可以根据特定情况和安全要求最合适的方式更改访问这些值的方式。
  • 该函数检查请求中是否提供了查询参数“leaderboardName”。
  • 然后,我们调用 LoginAsTitleEntity 方法以作为游戏实体进行身份验证,这是创建排行榜定义所必需的。
  • 最后,我们调用 CreateLeaderboardDefinitionAsync 方法,使用所提供的名称创建排行榜定义。若要详细了解排行榜的创建,请参阅 创建基础排行榜排行榜的更多用法
RunAsync 方法作为 Azure Function 的入口点。从那里,您可以定义并调用其他方法以构建自定义游戏逻辑。如何处理错误或与多个 PlayFab 服务交互完全取决于您,从而使您在实现中具有完全的灵活性。 此外,您可以配置自动化规则以基于特定事件触发此 Azure Function。有关更多详细信息,请参阅此处

另请参阅

最后修改于 2026年8月13日