通过 GameId 加载游戏
本文档介绍如何通过 GameId 启动游戏,并将游戏视图加载到应用页面中。
概述
通过 SUDOP.startGame 接口,可以根据游戏的唯一标识 gameId 启动游戏。
在 onGameViewCreated 回调中将 View 添加到 UI 容器,即可展示 SDK 加载页及后续游戏画面。通过 onProgress 获取加载进度,通过 onSuccess 或 onFailure 获取启动结果。
完整流程
启动游戏前,必须依次完成以下步骤:
- 初始化 SDK(
initSDK) - 用户鉴权(
auth) - 启动游戏(
startGame)
示例代码
以下代码在主线程调用。container 为已初始化的页面容器,gameTask 为页面持有的 SUDOPGameTask 字段。将 language 设置为应用所需的 BCP 47 语言标签,可与 getGameInformation 使用相同的值。
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
public static SUDOPGameTask startGame(String gameId, SUDOPStartGameListener listener);
public static SUDOPGameTask startGame(String gameId, String language, SUDOPStartGameListener listener);参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| gameId | String | 必填,游戏唯一标识 |
| language | String | 可选,BCP 47 语言标签,例如 zh-CN、en-US |
| listener | SUDOPStartGameListener | 必填,启动过程监听器 |
语言与加载页展示
不需要指定语言时,可继续使用原有的 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 后,可通过以下回调展示游戏并跟踪启动状态:
- 在
onGameViewCreated中挂载游戏视图,展示加载页 - 加载页按上述语言规则显示游戏名称和图标
- 通过
onProgress获取启动进度 - 在
onSuccess中处理启动成功,或在onFailure中处理启动失败
UI 集成说明
你需要准备一个容器,例如:
FrameLayout container;在 onGameViewCreated(View view) 中:
container.addView(view);注意事项
1. 必须完成初始化和鉴权
顺序不可错:
initSDK → auth → startGame2. 必须持有 GameTask
gameTask = SUDOP.startGame(gameId, language, listener);在页面销毁时:
if (gameTask != null) {
gameTask.destroy();
}3. 单实例运行
建议同一时间只运行一个游戏实例。
4. UI 线程安全
在主线程调用 startGame。onGameViewCreated 会在启动调用期间同步返回,可在此挂载游戏容器。
总结
通过 gameId 加载游戏 = 调用 startGame → onGameViewCreated 挂载视图 → onSuccess 启动成功上述代码示例为Android的代码示例,iOS亦是相同流程,具体可查看:iOS API
