Skip to content

getCategories ​

获取品类列表 ​

POST /v1/game/getCategories

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

方法声明 ​

java
public static void getCategories(SUDOPCategoryListParams params, SUDOPCategoryListCallback callback);

参数说明 ​

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

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

回调与返回结果 ​

java
public interface SUDOPCategoryListCallback {
    void onSuccess(SUDOPCategoryListResult result);
    void onFailure(int retCode, String retMsg);
}

回调在主线程执行。callback 为 null 时直接返回,不发送请求。

SUDOPCategoryListResult ​

字段类型描述
pageNoint当前页码,从 0 开始。
pageSizeint每页条数。
totalint品类总记录数。
recordsList<SUDOPCategoryListItem>当前页的品类记录。

SUDOPCategoryListItem ​

字段类型描述
codeString品类编码。
nameMap<String, String>多语言名称,key 为语言标签,default 为默认名称。
parentCodeString父品类编码,对应响应中的 parent_code。
levelint1:一级品类;2:二级品类。

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

代码示例 ​

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

java
SUDOPCategoryListParams params = new SUDOPCategoryListParams();
params.pageNo = 0;
params.pageSize = 20;
params.language = "zh-CN";

SUDOP.getCategories(params, new SUDOPCategoryListCallback() {
    @Override
    public void onSuccess(SUDOPCategoryListResult result) {
        Log.i("SUDOP", "page=" + result.pageNo + ", total=" + result.total);
        for (SUDOPCategoryListItem item : result.records) {
            Log.i("SUDOP", "code=" + item.code + ", parentCode=" + item.parentCode + ", level=" + item.level);
        }
    }

    @Override
    public void onFailure(int retCode, String retMsg) {
        Log.e("SUDOP", "Request failed: " + retCode + ", " + retMsg);
    }
});

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