Skip to content

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 参数的重载方法。


参数说明 ​

参数名类型描述
gameIDString需要获取信息的游戏 ID。
languageStringBCP 47 语言标签,例如 zh-CN、en-US。不指定语言时,可使用不含此参数的重载方法。
listenerSUDOPGetGameInformationListener用于接收游戏信息获取结果的监听器。

结果监听器 ​

java
public interface SUDOPGetGameInformationListener {
    void onSuccess(SUDOPGameInformationModel model);
    void onFailure(int retCode, String retMsg);
}
方法参数类型描述
onSuccessmodelSUDOPGameInformationModel获取成功时返回的游戏信息对象,字段说明见下表。
onFailureretCodeint获取失败时返回的错误码。
onFailureretMsgString获取失败时返回的错误描述。

返回模型 SUDOPGameInformationModel ​

字段类型描述
game_idString游戏 ID。
game_nameMap<String, String>游戏名(多语言)。
game_iconString游戏图标 URL。
iconMap<String, String>游戏图标 URL(多语言)。
game_introductionMap<String, String>游戏简介(多语言)。
game_descriptionMap<String, String>游戏详情(多语言)。
categoryint游戏分类:1-角色扮演,2-经营策略,3-休闲益智,4-动作冒险,5-射击游戏,6-体育竞速,7-棋牌游戏,8-音乐舞蹈。
service_phoneString客服电话。
service_emailString客服邮箱。
subject_typeint认证类型:0-个人,1-企业。
subject_nameString认证主体:企业全称或个人姓名。
privacy_policy_urlString隐私政策 URL。
privacyPolicyMap<String, String>隐私政策 URL(多语言)。
versionString游戏版本号。
update_timelong更新时间戳,单位为毫秒。

所有 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) 重载方法。