Skip to content

startGame ​

启动游戏(通过游戏 ID) ​

startGame 根据游戏 ID 启动游戏。可通过 language 指定 SDK 加载页中游戏名称和图标的显示语言。


调用前置条件 ​

调用前必须先完成 SUDOP.initSDK 初始化和 SUDOP.auth 用户鉴权,并确保两者成功。在主线程调用并准备好用于挂载游戏视图的容器。


方法声明 ​

java
// 不指定语言,保留原有调用方式
public static SUDOPGameTask startGame(String gameId, SUDOPStartGameListener listener);

// 指定语言
public static SUDOPGameTask startGame(String gameId, String language, SUDOPStartGameListener listener);

参数说明 ​

参数名类型描述
gameIdString必填,需要启动的游戏 ID。
languageString可选的 BCP 47 语言标签,例如 zh-CN、en-US,用于选择加载页中游戏名称和图标的显示语言。
listenerSUDOPStartGameListener必填,启动过程监听器。

返回 SUDOPGameTask,用于管理游戏生命周期。原有重载等同于传入 language = null。

SUDOPStartGameListener ​

  • void onGameViewCreated(View view):游戏容器创建完成,在此将 view 添加到应用布局,以展示加载页及后续游戏画面。
  • void onGamePkgDecrypt(GamePkgDecryptHandle handle, String filePath):供文件路径或 URL 加载流程处理自定义游戏包解密;通过游戏 ID 启动时无需在此处理。
  • void onCreated(SUDRTGameHandle gameHandle, SUDOPGameInfo gameInfo):游戏实例创建完成,可设置启动参数或交互监听器。
  • void onSuccess(String gameId, SUDRTGameHandle gameHandle):游戏启动成功,无需重复添加已挂载的视图。
  • void onProgress(int progress):启动进度,范围为 0–100。
  • void onFailure(int retCode, String retMsg):游戏启动失败。

GamePkgDecryptHandle ​

  • void success(String decryptedFilePath, boolean isDeleteFile):解密成功,传入解密后的路径及加载后是否删除该文件。
  • void fail(int retCode, String retMsg):解密失败,传入错误码及错误信息。

加载页语言与回退规则 ​

SDK 加载页按以下规则展示游戏名称与图标:

  1. language 非空时使用传入值;未传、为 null 或空字符串时,使用系统语言。
  2. 游戏名优先显示 game_name 中对应语言的名称;该语言的值缺失或为空时,显示 game_name.default。
  3. 图标始终优先使用 icon 中对应语言的 URL;该语言的 URL 缺失或为空时,使用 icon.default。
  4. 如果从 icon 仍取不到非空 URL,再使用原有 game_icon 图标;均为空时不显示游戏图标。

语言标签按 Map 中的 key 精确匹配。例如,传入 en-US 时不会自动改为匹配 en。图标回退依据是 URL 是否存在且非空,不是在图片下载失败后切换 URL。


代码示例 ​

以下代码在初始化、鉴权成功后于主线程调用,container 为页面上已初始化的 FrameLayout。将 language 设置为应用所需的 BCP 47 语言标签,可与 getGameInformation 使用相同的值。

java
String language = "zh-CN";
SUDOPGameTask gameTask = SUDOP.startGame("game_101", language, new SUDOPStartGameListener() {
    @Override
    public void onGameViewCreated(View view) {
        container.addView(view, new FrameLayout.LayoutParams(
                FrameLayout.LayoutParams.MATCH_PARENT, FrameLayout.LayoutParams.MATCH_PARENT));
    }

    @Override
    public void onGamePkgDecrypt(GamePkgDecryptHandle handle, String filePath) {
        // 通过游戏 ID 启动时无需处理
    }

    @Override
    public void onCreated(SUDRTGameHandle gameHandle, SUDOPGameInfo gameInfo) {
        // 可在此设置启动参数或交互监听器
    }

    @Override
    public void onSuccess(String gameId, SUDRTGameHandle gameHandle) {
        // 游戏已启动,视图已在 onGameViewCreated 中挂载
    }

    @Override
    public void onProgress(int progress) {
        // 按需展示启动进度
    }

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

不指定语言时,继续使用 SUDOP.startGame(gameId, listener),加载页按系统语言执行上述匹配和回退规则。


注意事项 ​

  • 任务持有:页面应持有返回的 SUDOPGameTask,在页面销毁时检查非空并调用 gameTask.destroy()。
  • 视图挂载:在 onGameViewCreated 中挂载一次即可,不要在 onSuccess 中重复添加。
  • 单一实例:在同一时间内,建议只运行一个游戏实例。