Skip to content

startGameBySignature ​

启动游戏(通过游戏签名) ​

startGameBySignature 是生产环境下最推荐的启动方式。它通过从服务端获取的加密**游戏签名(Game Signature)**来启动游戏,确保了游戏版本的合法性、安全性和用户权限的有效性。

该接口会自动处理资源比对、静默下载(若本地无匹配版本)以及环境初始化。


方法声明 ​

java
/**
 * 启动游戏,根据游戏签名
 *
 * @param signature         游戏签名
 * @param listener          启动过程监听器
 * @return SUDOPGameTask    任务句柄
 */
public static SUDOPGameTask startGameBySignature(String signature, SUDOPStartGameListener listener);

/* 指定加载页游戏名称和图标的语言。 */
public static SUDOPGameTask startGameBySignature(
    String signature, String language, SUDOPStartGameListener listener);

参数说明 ​

属性类型描述
signatureString必填。通过 getGameSignature 获取的加密签名字符串。
languageString三参数重载中的可选参数。BCP 47 语言标签,例如 en、zh-CN、zh-Hant-TW,用于选择 SDK 加载页的游戏名称和图标。传入 null 或空字符串时,使用加载页当前的语言环境。
listenerSUDOPStartGameListener启动过程监听器,回调说明见下文。

1. SUDOPStartGameListener ​

  • void onGamePkgDecrypt(GamePkgDecryptHandle handle, String filePath):游戏包解密回调。
  • void onCreated(SUDRTGameHandle gameHandle, SUDOPGameInfo gameInfo):游戏实例创建完成。gameHandle为游戏实例句柄,可用于后续控制游戏生命周期或交互。
  • void onSuccess(String gameId, SUDRTGameHandle gameHandle):游戏启动成功。
  • void onFailure(int retCode, String retMsg):游戏启动失败。

2. GamePkgDecryptHandle ​

  • void success(String decryptedFilePath, boolean isDeleteFile):解密成功。decryptedFilePath:解密后的文件路径。isDeleteFile:游戏加载完成后是否删除该文件。

  • void fail(int retCode, String retMsg):解密失败。retCode:错误码。retMsg:错误信息描述。


运行行为 ​

  1. 安全校验:SDK 首先验证签名的合法性,解析出对应的 gameId 和版本约束。
  2. 热更新检查:对比本地缓存。若服务端有更新,将触发增量下载。
  3. 环境复用:如果之前调用过 preStart 或 preLoad 且签名匹配,SDK 将直接返回已就绪的视图,实现瞬开。
  4. 渲染激活:onSuccess 回调后,游戏开始处理触摸事件并播放音频。

加载页语言 ​

原两参数方法继续保留。使用新增重载传入 BCP 47 语言标签,可指定 SDK 加载页展示的游戏名称和图标的语言。App 支持语言切换时,建议传入当前 Activity 的语言标签。

language 为 null 或空字符串时,SDK 使用加载页当前的语言环境。实际展示内容取决于游戏提供的多语言资源;没有完全匹配的资源时,SDK 会进行回退选择。

此参数仅作用于加载页,游戏内部语言仍通过 getAppBaseInfo.language 设置。


代码示例 ​

java
String signature = "SERVER_SIDE_ENCRYPTED_SIGNATURE";
String language = "zh-Hant-TW"; // 示例;实际接入时可使用当前 Activity 的语言。
SUDOPGameTask gameTask = SUDOP.startGameBySignature(signature, language, new SUDOPStartGameListener() {
    @Override
    public void onGameViewCreated(View view) {
        // 在此将 view 添加到宿主布局。
    }

    @Override
    public void onProgress(int progress) {
        // 更新加载进度,范围 0~100。
    }

    @Override
    public void onGamePkgDecrypt(GamePkgDecryptHandle handle, String filePath) {
    }
    @Override
    public void onCreated(SUDRTGameHandle gameHandle, SUDOPGameInfo gameInfo) {
    }
    @Override
    public void onSuccess(String gameId, SUDRTGameHandle gameHandle) {
        // 将这个View贴到app自身的页面上即可
        View gameView = gameHandle.getGameView();
    }
    @Override
    public void onFailure(int retCode, String retMsg) {
    }
});

注意事项 ​

  • 签名失效性:签名通常有较短的有效期。如果用户在启动页停留过久导致签名过期,需重新获取。
  • 实例唯一性:调用此方法会销毁当前进程内已有的其他游戏运行实例,以确保资源独占。
  • 生命周期同步:请务必在 Activity 的 onDestroy 中调用 task.destroy(),否则游戏可能在后台持续消耗资源。

还需实现 onGameViewCreated(View view) 和 onProgress(int progress);前者用于挂载游戏视图,后者报告 0~100 的进度。onCreated 的 gameInfo 为 SUDOPGameInfo 游戏信息。