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 / gameID | String | 需要获取签名的游戏 ID。 |
| language | String | 获取游戏签名时使用的语言,可选的 BCP 47 语言标签,例如 zh-CN、en-US。 |
| listener | SUDOPGetGameSignatureListener | 用于接收签名或错误信息的监听器。 |
不需要指定语言时,可使用不含 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_name | object | 游戏名(多语言),对应 Map<String, String>。 |
| icon | object | 游戏图标 URL(多语言),结构与 game_name 相同。 |
| game_icon | string | 原有的游戏图标 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)。
