为版本控制创建排行榜定义
在之前的示例中,创建排行榜定义时,有一处提示表明VersionConfiguration 参数对于版本控制的重要性。下面我们详细介绍如何使用它以及它的工作方式。
VersionConfiguration 参数。此参数允许我们定义一个 MaxQueryableVersions 设置,指定我们可以查询同一排行榜的多少个版本。在本例中,我们将其设置为查询 12 个版本,这允许查询最近的 12 个排行榜。ResetInterval 参数定义重置过程发生的频率。此操作涉及创建一个与之前配置相同但为空的排行榜,并且版本参数按如下方式变化:N = N + 1,在排行榜定义创建时 N = 0。
例如,假设我们有一个排行榜,其版本参数为二,排行榜上有一百个条目。现在,当我们递增该排行榜的版本时,结果将是一个版本参数为三且为空的新排行榜。同时,先前的排行榜仍保留在系统中以供查询。
ResetInterval 可以有多种工作方式。在此示例中,它是按月的,但可以根据开发者的需要进行更改。在此特定情况下,这意味着排行榜将从其配置时刻起每月自动重置。我们支持以下重置策略:
- Day
- Hour
- Manual
- Month
- Week
递增排行榜的版本
有了这个新配置,我们可以为锦标赛模式拥有同一排行榜的多个版本。但是,如果我们由于某个问题需要手动重置排行榜并重新开始锦标赛,会发生什么呢?在这种情况下,我们可以使用 API 执行手动重置。以下是使用 SDK 的示例:查询较旧版本
现在,如果我们需要查询排行榜的较旧版本,我们可以使用所有 GetLeaderboards API 上都可用的version 参数。以下是使用 SDK 的示例:
结论
在本教程中,我们学习了如何执行以下操作:- 使用正确的重置策略创建排行榜。
- 递增排行榜的版本。
- 查询排行榜的较旧版本。
