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);两种调用方式使用相同的分页参数、回调和返回模型。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
| selectionId | String | 查询指定选品单时必传,不能为空。 |
| params | SUDOPGameListParams | 可选的分页及语言参数,字段说明见下表。 |
| callback | SUDOPGameListCallback | 用于接收游戏列表获取结果的回调监听器。 |
SUDOPGameListParams
| 字段 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| pageNo | int | 0 | 页码,从 0 开始,小于 0 时按 0 处理。 |
| pageSize | int | 10 | 每页条数,小于或等于 0 时按 10 处理。 |
| language | String | null | 获取游戏列表时使用的语言,可选的 BCP 47 语言标签,例如 zh-CN、en-US。 |
不需要指定语言时,可不设置 language。传入 params = null 时,使用默认分页参数且不指定语言。
结果回调
java
public interface SUDOPGameListCallback {
void onSuccess(SUDOPGameListResult result);
void onFailure(int retCode, String retMsg);
}| 方法 | 参数 | 类型 | 描述 |
|---|---|---|---|
| onSuccess | result | SUDOPGameListResult | 获取成功时返回的分页结果。 |
| onFailure | retCode | int | 获取失败时返回的错误码。 |
| onFailure | retMsg | String | 获取失败时返回的错误描述。 |
返回模型 SUDOPGameListResult
| 字段 | 类型 | 描述 |
|---|---|---|
| pageNo | int | 当前页码,从 0 开始。 |
| pageSize | int | 每页条数。 |
| total | int | 总记录数。 |
| records | List<SUDOPGameListItem> | 当前页的游戏列表。 |
SUDOPGameListItem
| 字段 | 类型 | 描述 |
|---|---|---|
| gameId | String | 游戏 ID。 |
| gameName | Map<String, String> | 游戏名(多语言),key 为语言标签,value 为对应语言的游戏名。 |
| gameIcon | String | 游戏图标 URL。 |
| icon | Map<String, String> | 游戏图标 URL(多语言),结构与 gameName 相同。 |
| version | String | 游戏版本号。 |
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);
}
});