getRankingsListWithOptions:completion:
获取游戏榜单列表
获取当前可用的游戏榜单及其多语言名称、标题和描述。调用前须完成 SDK 初始化。该方法请求 /v1/game/getRankingsList。
方法声明
objectivec
+ (void)getRankingsListWithOptions:(nullable SUDOPRankingsListOptions *)options
completion:(nullable void(^)(SUDOPRankingsListResult *_Nullable result,
NSError *_Nullable error))completion;参数说明
| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| options | SUDOPRankingsListOptions * | 否 | 榜单查询参数;language 为 nil 或空字符串时使用服务端默认语言。 |
| completion | Block | 否 | 成功返回榜单列表,失败返回 NSError。 |
返回模型
SUDOPRankingsListResult.records 为 SUDOPRankingsListItem 数组:
| 字段 | 类型 | 描述 |
|---|---|---|
| rankId | NSString * | 榜单 ID,以字符串保留。 |
| name | NSDictionary<NSString *, NSString *> * | 多语言榜单名称。 |
| title | NSDictionary<NSString *, NSString *> * | 多语言榜单标题。 |
| rankingDescription | NSDictionary<NSString *, NSString *> * | 多语言榜单描述,对应服务端 description 字段。 |
代码示例
objectivec
SUDOPRankingsListOptions *options = [[SUDOPRankingsListOptions alloc] init];
options.language = @"zh-CN";
[SUDOP getRankingsListWithOptions:options
completion:^(SUDOPRankingsListResult * _Nullable result,
NSError * _Nullable error) {
if (error) {
NSLog(@"获取榜单失败: %@", error.localizedDescription);
return;
}
for (SUDOPRankingsListItem *item in result.records) {
NSLog(@"榜单 ID: %@,名称: %@", item.rankId, item.name);
}
}];注意事项
rankId应保持为字符串,不要通过浮点数或窄整数类型中转。- 获取榜单中的游戏时,将
rankId传给getGameListByRankIdWithOptions:completion:。
