getGameInformation
获取游戏信息
getGameInformation 方法用于获取指定游戏的信息。支持传入 BCP 47 语言标签,也支持通过重载方法仅传入游戏 ID 和结果监听器。
调用前置条件
调用 getGameInformation 前,必须先调用 SUDOP.initSDK 并确保初始化成功。此要求适用于两个重载方法。
方法声明
java
/**
* 获取游戏信息
*
* @param gameID 游戏 ID
* @param language BCP 47 语言标签
* @param listener 游戏信息获取结果的监听器
*/
public static void getGameInformation(String gameID, String language, SUDOPGetGameInformationListener listener);
/**
* 获取游戏信息(不指定语言)
*
* @param gameID 游戏 ID
* @param listener 游戏信息获取结果的监听器
*/
public static void getGameInformation(String gameID, SUDOPGetGameInformationListener listener);不需要指定语言时,可使用不含 language 参数的重载方法。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
| gameID | String | 需要获取信息的游戏 ID。 |
| language | String | BCP 47 语言标签,例如 zh-CN、en-US。不指定语言时,可使用不含此参数的重载方法。 |
| listener | SUDOPGetGameInformationListener | 用于接收游戏信息获取结果的监听器。 |
结果监听器
java
public interface SUDOPGetGameInformationListener {
void onSuccess(SUDOPGameInformationModel model);
void onFailure(int retCode, String retMsg);
}| 方法 | 参数 | 类型 | 描述 |
|---|---|---|---|
| onSuccess | model | SUDOPGameInformationModel | 获取成功时返回的游戏信息对象,字段说明见下表。 |
| onFailure | retCode | int | 获取失败时返回的错误码。 |
| onFailure | retMsg | String | 获取失败时返回的错误描述。 |
返回模型 SUDOPGameInformationModel
| 字段 | 类型 | 描述 |
|---|---|---|
| game_id | String | 游戏 ID。 |
| game_name | Map<String, String> | 游戏名(多语言)。 |
| game_icon | String | 游戏图标 URL。 |
| icon | Map<String, String> | 游戏图标 URL(多语言)。 |
| game_introduction | Map<String, String> | 游戏简介(多语言)。 |
| game_description | Map<String, String> | 游戏详情(多语言)。 |
| category | int | 游戏分类:1-角色扮演,2-经营策略,3-休闲益智,4-动作冒险,5-射击游戏,6-体育竞速,7-棋牌游戏,8-音乐舞蹈。 |
| service_phone | String | 客服电话。 |
| service_email | String | 客服邮箱。 |
| subject_type | int | 认证类型:0-个人,1-企业。 |
| subject_name | String | 认证主体:企业全称或个人姓名。 |
| privacy_policy_url | String | 隐私政策 URL。 |
| privacyPolicy | Map<String, String> | 隐私政策 URL(多语言)。 |
| version | String | 游戏版本号。 |
| update_time | long | 更新时间戳,单位为毫秒。 |
所有 Map<String, String> 字段均至少包含一个 default key,其 value 为默认值。除 default 外,其他 key 为 language(BCP 47 语言标签,例如 zh-CN、en-US),value 为对应语言的值。
例如,game_name.get("default") 获取默认游戏名,game_name.get("zh-CN") 获取简体中文游戏名,icon.get("en-US") 获取对应英语语言标签的游戏图标 URL。未包含所需语言的 key 时,可读取 default 对应的值。
代码示例
java
String gameID = "game_101";
String language = "zh-CN";
SUDOPGetGameInformationListener listener = new SUDOPGetGameInformationListener() {
@Override
public void onSuccess(SUDOPGameInformationModel model) {
// 按语言标签读取对应的游戏名
String gameName = model.game_name.get(language);
Log.i("SUDOP", "游戏名: " + gameName);
}
@Override
public void onFailure(int retCode, String retMsg) {
Log.e("SUDOP", "获取游戏信息失败: " + retCode + ", " + retMsg);
}
};
// 指定语言
SUDOP.getGameInformation(gameID, language, listener);
// 不指定语言
SUDOP.getGameInformation(gameID, listener);注意事项
需要指定语言时,在 gameID 和 listener 之间传入 language;不需要指定语言时,可继续使用 getGameInformation(gameID, listener) 重载方法。
