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);参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
| gameId | String | 必填,需要启动的游戏 ID。 |
| language | String | 可选的 BCP 47 语言标签,例如 zh-CN、en-US,用于选择加载页中游戏名称和图标的显示语言。 |
| listener | SUDOPStartGameListener | 必填,启动过程监听器。 |
返回 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 加载页按以下规则展示游戏名称与图标:
language非空时使用传入值;未传、为null或空字符串时,使用系统语言。- 游戏名优先显示
game_name中对应语言的名称;该语言的值缺失或为空时,显示game_name.default。 - 图标始终优先使用
icon中对应语言的 URL;该语言的 URL 缺失或为空时,使用icon.default。 - 如果从
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中重复添加。 - 单一实例:在同一时间内,建议只运行一个游戏实例。
