启动与连接
启动与连接是所有 IGP SDK 功能的共同前置流程。它负责确认游戏身份、连接本机 IGP 桌面客户端，并让游戏知道当前会话可以使用哪些平台能力。
这项功能负责什么
Section titled “这项功能负责什么”- 使用平台分配的
appId标识当前游戏。 - 由游戏启动流程显式初始化 SDK。
- 建立并维护 Desktop Session。
- 提供连接、授权、错误和 capability 状态。
- 在桌面客户端暂时不可用时给出明确结果，供游戏决定重试或提示玩家。
成就、正版校验、实名认证与防沉迷都使用 Desktop Session。房间、实时消息和网络传输另走 Hosted Session；Desktop Session 已连接不代表已经进入联机大厅。
| 引擎 | 状态 | 主入口 | 详细操作 |
|---|---|---|---|
| Unity | Preview | 主包中的运行时管理器 | Unity 安装 · Unity Quick Start |
| GameMaker | Preview | Windows runtime | GameMaker 安装 · GameMaker Quick Start |
| Godot | Preview | Core addon 注册的 IGP Autoload | Godot 安装 · Godot Quick Start |
- 下载与引擎版本匹配的主包；Godot 必须选择精确版本 variant。
- 将主包导入工程，并按引擎说明启用运行时入口。
- 在 SDK 配置中填写正整数
appId。常规接入不需要运行目录、可执行文件路径或本地 pipe 配置。 - 先订阅连接、授权和错误事件，再从游戏自己的启动流程调用初始化。
- 等待初始化返回明确结果，并确认 Desktop Session 已连接。
- 调用具体功能前检查当前会话发布的 capability，不要假定所有桌面客户端版本都支持全部能力。
游戏如何使用连接状态
Section titled “游戏如何使用连接状态”- 正在连接：保持启动界面可响应，避免重复发起同一初始化。
- 已连接但未就绪：继续等待正版校验结果，不要提前进入受保护的游戏流程。
- 已就绪：可以使用当前 capability 允许的成就、用户、合规等能力。
- 连接失败或断开：向玩家给出可操作的提示，并按引擎提供的入口重试；不要无限快速重连。
- 使用正确
appId启动时，初始化得到成功结果并能看到 Desktop Session 已连接。 - 使用无效
appId或关闭桌面客户端时，游戏能收到明确失败状态，而不是一直等待。 - 重新连接后，授权和 capability 状态会恢复到当前会话的真实值。
- 只接入非联机功能时，不以房间或 realtime 状态作为启动成功条件。