Skip to content

getGameSignature ​

获取游戏签名 ​

getGameSignature 方法用于获取指定游戏的启动签名,支持传入 BCP 47 语言标签。返回的签名字符串可用于 startGameBySignature。


调用前置条件 ​

调用前必须先调用 SUDOP.initSDK 并确保初始化成功。后续启动游戏前,还需要通过 SUDOP.auth 完成用户鉴权。


方法声明 ​

java
// 不指定语言,保留原有调用方式
public static void getGameSignature(String gameID, SUDOPGetGameSignatureListener listener);

// 指定语言
public static void getGameSignature(String gameId, String language, SUDOPGetGameSignatureListener listener);

参数说明 ​

参数名类型描述
gameId / gameIDString需要获取签名的游戏 ID。
languageString获取游戏签名时使用的语言,可选的 BCP 47 语言标签,例如 zh-CN、en-US。
listenerSUDOPGetGameSignatureListener用于接收签名或错误信息的监听器。

不需要指定语言时,可使用不含 language 的原有重载,或传入 language = null。


结果监听器 ​

java
public interface SUDOPGetGameSignatureListener {
    void onSuccess(String gameSignature);
    void onFailure(int retCode, String retMsg);
}
  • onSuccess:获取成功,返回完整的游戏签名 JSON 字符串 gameSignature。
  • onFailure:获取失败,返回错误码 retCode 和错误描述 retMsg。

game_meta_str 中的多语言字段 ​

gameSignature 中的 game_meta_str 是 JSON 字符串。解析后的游戏元数据包含以下展示字段:

字段JSON 类型描述
game_nameobject游戏名(多语言),对应 Map<String, String>。
iconobject游戏图标 URL(多语言),结构与 game_name 相同。
game_iconstring原有的游戏图标 URL,供多语言图标缺失时回退使用。

game_name 和 icon 的 key 为 BCP 47 语言标签,default 表示默认值。以下仅展示解析后的相关字段,不是可用于启动游戏的完整签名:

json
{
  "game_name": {
    "default": "Demo Game",
    "zh-CN": "示例游戏",
    "en-US": "Demo Game"
  },
  "icon": {
    "default": "https://example.com/icon.png",
    "zh-CN": "https://example.com/icon-zh.png",
    "en-US": "https://example.com/icon-en.png"
  },
  "game_icon": "https://example.com/legacy-icon.png"
}

代码示例 ​

将 language 设置为应用所需的 BCP 47 语言标签,可与 getGameInformation 使用相同的值。

java
String gameId = "game_101";
String language = "zh-CN";

SUDOPGetGameSignatureListener listener = new SUDOPGetGameSignatureListener() {
    @Override
    public void onSuccess(String gameSignature) {
        // 将原始 gameSignature 传给 startGameBySignature;不要修改或输出完整签名
        Log.i("SUDOP", "获取游戏签名成功");
    }

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

// 指定语言
SUDOP.getGameSignature(gameId, language, listener);

// 不指定语言时,改用 SUDOP.getGameSignature(gameId, listener);

注意事项 ​

  • 签名完整性:解析元数据可用于展示,但不要修改或重新序列化 game_meta_str 后用于启动。应保留并传递接口返回的原始 gameSignature。
  • 安全性:gameSignature 包含敏感的授权信息,不要输出完整签名,建议仅在内存中传递。
  • 有效期:签名具有时效性,启动时返回签名失效错误后,需重新获取。
  • 加载页语言:将返回的签名原样传给 startGameBySignature(signature, language, listener),并传入当前 Activity 的语言,以选择加载页的游戏名称和图标。原两参数方法或 language 为 null、空字符串时,使用加载页当前的语言环境。按游戏 ID 启动时,可使用 startGame(gameId, language, listener)。