Skip to content

getCategoryListWithOptions:completion: ​

获取品类列表 ​

POST /v1/game/getCategories

先成功调用 initializeWithConfiguration,再完成用户鉴权后请求数据。鉴权 Header、签名及加密由 SDK 处理,服务端需支持对应接口。

方法声明 ​

objectivec
+ (void)getCategoryListWithOptions:(nullable SUDOPCategoryListOptions *)options
    completion:(nullable void(^)(SUDOPCategoryListResult *_Nullable result, NSError *_Nullable error))completion;

参数说明 ​

options 可传 nil。默认请求第 0 页、每页 10 条,语言使用服务端默认值。

参数 / 字段类型描述
pageNoNSInteger从 0 开始,小于 0 时按 0 处理。
pageSizeNSInteger默认 10,小于或等于 0 时按 10 处理。
languageNSString *可选的 BCP 47 语言标签,如 zh-CN。nil 或空字符串使用服务端默认语言,SDK 不自动替换为系统语言。

回调与返回结果 ​

成功返回 result,失败返回 error,completion 可传 nil。建议在主线程调用;本地参数校验失败可能在方法返回前直接触发回调。

SUDOPCategoryListResult ​

字段类型描述
pageNoNSInteger当前页码,从 0 开始。
pageSizeNSInteger每页条数。
totalNSInteger品类总记录数。
recordsNSArray<SUDOPCategoryListItem *> *当前页的品类记录。

SUDOPCategoryListItem ​

字段类型描述
codeNSString *品类编码。
nameNSDictionary<NSString *, NSString *> *多语言名称,key 为语言标签,default 为默认名称。
parentCodeNSString *父品类编码,对应响应中的 parent_code。
levelNSInteger1:一级品类;2:二级品类。

设置 language 后,name 仍为多语言 Map。优先读取所需语言的非空值,否则读取 default。取得品类编码后,可调用 getGameListWithCategoryOptions。

代码示例 ​

在初始化和鉴权成功后调用。示例品类编码需替换为实际值。

objectivec
SUDOPCategoryListOptions *options = [[SUDOPCategoryListOptions alloc] init];
options.pageNo = 0;
options.pageSize = 20;
options.language = @"zh-CN";

[SUDOP getCategoryListWithOptions:options completion:^(SUDOPCategoryListResult * _Nullable result, NSError * _Nullable error) {
    if (error) {
        NSLog(@"Request failed: %@", error.localizedDescription);
        return;
    }
    NSLog(@"page=%ld, total=%ld", (long)result.pageNo, (long)result.total);
    for (SUDOPCategoryListItem *item in result.records) {
        NSLog(@"code=%@, parentCode=%@, level=%ld", item.code, item.parentCode, (long)item.level);
    }
}];

根据返回的 pageNo、pageSize 和 total 判断是否还有下一页。