Godot 完整工程

每个公开 Godot variant 都提供两个独立完整工程：igp-godot-sdk-test.zip 覆盖 Core、Compliance 和 GameKit；igp-godot-multiplayer-sample.zip 覆盖 Arena 房间、TCP/UDP 数据面、Godot RPC 和自动 E2E。

SDKTest 下载组合

从 Release Notes 的同一行下载：

igp-godot-sdk-test.zip
igp-godot-sdk-core.zip
igp-godot-sdk-compliance.zip
igp-godot-sdk-game-kit.zip

四个文件必须属于同一个 Godot SDK 版本和同一个精确 Godot 版本。

运行步骤

解压 igp-godot-sdk-test.zip，得到 SDKTest/。
用匹配的 Godot 版本导入 SDKTest/project.godot。
按 Godot 安装将 Core、Compliance 和 GameKit ZIP 导入测试工程。
在 Project Settings > Plugins 启用 IGP SDK。
在 Project Settings > Igp > General 中把 igp/general/app_id 改为你的测试应用；同时确认 environment 与测试环境一致，不要沿用不属于当前应用的值。
等待原生库和资源导入完成，然后运行 main.tscn。

发布的测试工程模板不包含 SDK addon，也不包含 .godot、.import 等编辑器缓存，所以第一次打开前必须自行导入 SDK 包。

覆盖能力

Desktop Session、capability、正版校验和 Core 运行时事件。
当前用户、头像和头像字节。
成就解锁、累计进度、清除测试成就。
实名 Web 会话、防沉迷状态、Compliance 事件、年龄段与剩余时间。
Profile、批量玩家资料、排行榜读取与上传、文本/数据/图片分享。

初始化和只读状态会在启动后执行；成就、排行榜上传、分享等写操作只在点击对应按钮后执行。使用真实后台 key 前先确认测试账号和应用配置，避免把测试数据写入正式应用。

通过标准

页面能显示 attached、ready、authorization 和 capability 的明确状态。
Core、Compliance、GameKit 区域能识别已安装模块。
只读请求返回成功或可解释的业务错误。
写操作只有在按钮触发后发生，并显示对应结果。
退出请求、授权变化和错误会出现在事件日志中。

Multiplayer Sample

从 Release Notes 的同一行下载 igp-godot-multiplayer-sample.zip、Core 和 Multiplayer addon。解压得到 MultiplayerSample/ 后导入两个 addon；它们必须属于同一 SDK 版本和同一精确 Godot 版本。

工程 README 完整列出目录职责、手工双实例步骤和 Run-LocalE2E.ps1 参数。联机工程不启用 Desktop Autoload；自动 E2E 直接创建/加入 Arena 房间，取得每个玩家的 descriptor，并要求房主和客户端都收发可靠与不可靠消息。正式接入仍应使用 IGP.create_multiplayer_peer() 从 Hosted Session 获取 descriptor。

常见问题

原生库加载失败：检查 Godot 精确版本和 Windows x86_64 variant 是否一致。
IGP 不存在：确认 Core 已导入并启用 IGP SDK 插件。
可选模块为 null：确认可选包位于固定 res://addons/... 路径，并停止后重新运行工程。
APP_ID_REQUIRED：填写正确的正整数 igp/general/app_id。
capability 缺失：检查桌面客户端版本、登录状态、后台应用配置和当前环境。