Skip to content

getGameList ​

获取游戏列表 ​

getGameList 方法用于分页获取游戏列表,支持通过 SUDOPGameListParams.language 指定语言,通过回调返回分页信息和游戏列表数据。

带 selectionId 的重载用于获取指定选品单中的游戏。选品单 ID 可通过 getSelectionList 获取。

按品类查询请使用 getGameListByCategory,品类编码通过 getCategories 获取。


调用前置条件 ​

调用 getGameList 前,必须先调用 SUDOP.initSDK 并确保初始化成功。


方法声明 ​

java
/**
 * 获取游戏列表
 *
 * @param params   可选的分页及语言参数
 * @param callback 结果回调监听器
 */
public static void getGameList(SUDOPGameListParams params, SUDOPGameListCallback callback);

public static void getGameList(String selectionId, SUDOPGameListParams params,
                               SUDOPGameListCallback callback);

两种调用方式使用相同的分页参数、回调和返回模型。


参数说明 ​

参数名类型描述
selectionIdString查询指定选品单时必传,不能为空。
paramsSUDOPGameListParams可选的分页及语言参数,字段说明见下表。
callbackSUDOPGameListCallback用于接收游戏列表获取结果的回调监听器。

SUDOPGameListParams ​

字段类型默认值描述
pageNoint0页码,从 0 开始,小于 0 时按 0 处理。
pageSizeint10每页条数,小于或等于 0 时按 10 处理。
languageStringnull获取游戏列表时使用的语言,可选的 BCP 47 语言标签,例如 zh-CN、en-US。

不需要指定语言时,可不设置 language。传入 params = null 时,使用默认分页参数且不指定语言。


结果回调 ​

java
public interface SUDOPGameListCallback {
    void onSuccess(SUDOPGameListResult result);
    void onFailure(int retCode, String retMsg);
}
方法参数类型描述
onSuccessresultSUDOPGameListResult获取成功时返回的分页结果。
onFailureretCodeint获取失败时返回的错误码。
onFailureretMsgString获取失败时返回的错误描述。

返回模型 SUDOPGameListResult ​

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

SUDOPGameListItem ​

字段类型描述
gameIdString游戏 ID。
gameNameMap<String, String>游戏名(多语言),key 为语言标签,value 为对应语言的游戏名。
gameIconString游戏图标 URL。
iconMap<String, String>游戏图标 URL(多语言),结构与 gameName 相同。
versionString游戏版本号。

gameName 和 icon 的 key 为语言标签,例如 zh-CN、en-US,default 表示默认值。按所需语言取不到非空值时,可读取 default;icon 中仍取不到非空 URL 时,可使用原有的 gameIcon 字段。传入 language 后,返回字段仍是多语言 Map。


代码示例 ​

原游戏列表 ​

以下代码在 SUDOP.initSDK 初始化成功后调用。将 language 设置为应用所需的 BCP 47 语言标签,可与 getGameInformation 使用相同的值。

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

SUDOP.getGameList(params, new SUDOPGameListCallback() {
    @Override
    public void onSuccess(SUDOPGameListResult result) {
        Log.i("SUDOP", "当前页码: " + result.pageNo + ", 总记录数: " + result.total);
        for (SUDOPGameListItem item : result.records) {
            Log.i("SUDOP", "游戏 ID: " + item.gameId + ", 版本: " + item.version);
        }
    }

    @Override
    public void onFailure(int retCode, String retMsg) {
        Log.e("SUDOP", "获取游戏列表失败: " + retCode + ", " + retMsg);
    }
});

指定选品单的游戏列表 ​

初始化成功后调用,将示例 ID 替换为选品单列表返回的实际 ID;该查询不要求用户登录。

java
String selectionId = "123"; // 替换为实际选品单 ID
SUDOPGameListParams params = new SUDOPGameListParams();
params.language = "zh-CN";

SUDOP.getGameList(selectionId, params, new SUDOPGameListCallback() {
    @Override
    public void onSuccess(SUDOPGameListResult result) {
        Log.i("SUDOP", "当前选品单的游戏数: " + result.total);
    }

    @Override
    public void onFailure(int retCode, String retMsg) {
        Log.e("SUDOP", "获取选品单游戏失败: " + retCode + ", " + retMsg);
    }
});