Skip to content

getRankingsListWithOptions:completion: ​

获取游戏榜单列表 ​

获取当前可用的游戏榜单及其多语言名称、标题和描述。调用前须完成 SDK 初始化。该方法请求 /v1/game/getRankingsList。


方法声明 ​

objectivec
+ (void)getRankingsListWithOptions:(nullable SUDOPRankingsListOptions *)options
                        completion:(nullable void(^)(SUDOPRankingsListResult *_Nullable result,
                                                      NSError *_Nullable error))completion;

参数说明 ​

参数类型必传描述
optionsSUDOPRankingsListOptions *否榜单查询参数;language 为 nil 或空字符串时使用服务端默认语言。
completionBlock否成功返回榜单列表,失败返回 NSError。

返回模型 ​

SUDOPRankingsListResult.records 为 SUDOPRankingsListItem 数组:

字段类型描述
rankIdNSString *榜单 ID,以字符串保留。
nameNSDictionary<NSString *, NSString *> *多语言榜单名称。
titleNSDictionary<NSString *, NSString *> *多语言榜单标题。
rankingDescriptionNSDictionary<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:。