Skip to content

通过 GameId 加载游戏 ​

本文档介绍如何通过 GameId 启动游戏,并将游戏视图加载到应用页面中。


概述 ​

通过 SUDOP.startGame 接口,可以根据游戏的唯一标识 gameId 启动游戏。

在 onGameViewCreated 回调中将 View 添加到 UI 容器,即可展示 SDK 加载页及后续游戏画面。通过 onProgress 获取加载进度,通过 onSuccess 或 onFailure 获取启动结果。


完整流程 ​

启动游戏前,必须依次完成以下步骤:

  1. 初始化 SDK(initSDK)
  2. 用户鉴权(auth)
  3. 启动游戏(startGame)

示例代码 ​

以下代码在主线程调用。container 为已初始化的页面容器,gameTask 为页面持有的 SUDOPGameTask 字段。将 language 设置为应用所需的 BCP 47 语言标签,可与 getGameInformation 使用相同的值。

java
String language = "zh-CN";
SUDOP.initSDK(context, "Your appId", "Your appKey", new SUDOPInitSDKListener() {
    @Override
    public void onSuccess() {
        SUDOP.auth("Your user signature", new SUDOPAuthListener() {
            @Override
            public void onSuccess() {
                gameTask = SUDOP.startGame("You need to load the game id", 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) {
                        // 按需展示启动进度,范围为 0–100
                    }

                    @Override
                    public void onFailure(int retCode, String retMsg) {
                        // 游戏加载失败
                    }
                });
            }

            @Override
            public void onFailure(int retCode, String retMsg) {
                // 鉴权失败
            }
        });
    }

    @Override
    public void onFailure(int retCode, String retMsg) {
        // SDK 初始化失败
    }
});

核心接口说明 ​

startGame ​

java
public static SUDOPGameTask startGame(String gameId, SUDOPStartGameListener listener);

public static SUDOPGameTask startGame(String gameId, String language, SUDOPStartGameListener listener);

参数说明 ​

参数类型描述
gameIdString必填,游戏唯一标识
languageString可选,BCP 47 语言标签,例如 zh-CN、en-US
listenerSUDOPStartGameListener必填,启动过程监听器

语言与加载页展示 ​

不需要指定语言时,可继续使用原有的 startGame(gameId, listener) 重载,或传入 language = null。

SDK 加载页使用传入的非空语言;未传、为 null 或空字符串时,使用系统语言。游戏名称和图标优先显示 game_name 和 icon 中与语言标签精确匹配的值;该语言的值缺失或为空时,使用各自的 default。图标仍没有可用 URL 时,使用原有 game_icon 图标。

完整规则见 startGame API。


回调说明 ​

SUDOPStartGameListener ​

  • void onGameViewCreated(View view) 游戏容器创建完成,在此挂载 View,以显示加载页及游戏画面。

  • void onGamePkgDecrypt(GamePkgDecryptHandle handle, String filePath) 游戏包解密回调,通过游戏 ID 启动时无需处理。

  • void onCreated(SUDRTGameHandle gameHandle, SUDOPGameInfo gameInfo) 游戏实例创建完成 可在此设置游戏方向、启动参数或业务回调

  • void onSuccess(String gameId, SUDRTGameHandle gameHandle) 游戏启动成功,无需重复挂载 View。

  • void onProgress(int progress) 启动进度,范围为 0–100。

  • void onFailure(int retCode, String retMsg) 游戏启动失败

    常见原因:

    • gameId 错误
    • 网络异常
    • 鉴权失败

GamePkgDecryptHandle ​

  • void success(String decryptedFilePath, boolean isDeleteFile) 解密成功

  • void fail(int retCode, String retMsg) 解密失败


启动流程 ​

调用 startGame 后,可通过以下回调展示游戏并跟踪启动状态:

  1. 在 onGameViewCreated 中挂载游戏视图,展示加载页
  2. 加载页按上述语言规则显示游戏名称和图标
  3. 通过 onProgress 获取启动进度
  4. 在 onSuccess 中处理启动成功,或在 onFailure 中处理启动失败

UI 集成说明 ​

你需要准备一个容器,例如:

java
FrameLayout container;

在 onGameViewCreated(View view) 中:

java
container.addView(view);

注意事项 ​

1. 必须完成初始化和鉴权 ​

顺序不可错:

text
initSDK → auth → startGame

2. 必须持有 GameTask ​

java
gameTask = SUDOP.startGame(gameId, language, listener);

在页面销毁时:

java
if (gameTask != null) {
    gameTask.destroy();
}

3. 单实例运行 ​

建议同一时间只运行一个游戏实例。


4. UI 线程安全 ​

在主线程调用 startGame。onGameViewCreated 会在启动调用期间同步返回,可在此挂载游戏容器。


总结 ​

text
通过 gameId 加载游戏 = 调用 startGame → onGameViewCreated 挂载视图 → onSuccess 启动成功

上述代码示例为Android的代码示例,iOS亦是相同流程,具体可查看:iOS API