Godot 概览
IGP Godot SDK 以精确 Godot 版本分别交付。Godot 4.7.1 和 4.4.1 使用 GDExtension，Godot 3.6.2 使用 GDNative；接入项目不需要 C#/.NET、额外 protobuf runtime、游戏运行目录或可执行文件路径。
| 下载项 | 是否必需 | 安装位置 | 能力 |
|---|---|---|---|
| Core | 是 | res://addons/igp_sdk | Desktop Session、正版校验、成就、用户与头像、运行时事件 |
| Compliance | 否 | res://addons/igp_sdk_compliance | 实名认证、防沉迷、合规判断和默认阻断窗口 |
| GameKit | 否 | res://addons/igp_sdk_game_kit | Profile、玩家资料、排行榜和分享 |
| Multiplayer | 否 | res://addons/igp_sdk_multiplayer | Godot 原生 peer、Hosted Session、Arena TCP/UDP 数据面和 RPC |
| SDK Test | 测试用 | 独立 SDKTest/ 工程 | Core、Compliance、GameKit 的完整可运行验证界面 |
| Multiplayer Sample | 测试用 | 独立 MultiplayerSample/ 工程 | 房间控制面、可靠/不可靠传输、权威同步和本地 E2E |
Core 是唯一必须安装并在 Project Settings > Plugins 中启用的插件。Compliance、GameKit 和 Multiplayer 依赖 Core，但不注册额外插件；未安装时对应模块不可用。
推荐接入路径
Section titled “推荐接入路径”- Godot 安装：选择精确版本 ZIP，导入 Core 和可选包，启用插件并填写
appId。 - Godot Quick Start：订阅必要 signal，初始化 Desktop Session，并确认授权与 capability。
- Godot 完整工程：用同版本 SDKTest 验证 Desktop 能力，或用 Multiplayer Sample 验证联机数据面与 RPC。
- 回到功能页接入 正版校验、实名认证与防沉迷 或 成就。
当前公开能力
Section titled “当前公开能力”- 自动或显式连接 IGP Desktop Session，并读取连接、授权和 capability 状态。
- 解锁成就、上报累计进度和清除测试成就。
- 读取当前用户资料、头像信息和头像原始字节。
- 通过 Compliance 创建实名 Web 会话，读取防沉迷状态、年龄段、剩余时长和统一合规事件。
- 通过 GameKit 读取玩家资料与排行榜、上传分数，并发起文本、结构化数据和图片分享。
- 通过 Godot 原生 Multiplayer API 连接 Hosted Session 与 Arena TCP/UDP 数据面，并使用可靠和不可靠 RPC。
- 在 Godot 主线程接收连接、授权、离线地图启动、优雅退出和错误等运行时事件。
每个精确版本都提供 igp-godot-sdk-test.zip 与 igp-godot-multiplayer-sample.zip。它们不是 addon，也不是 Godot Asset Library 导入包：先解压为独立工程，再导入同一 SDK 版本和同一 Godot variant 的所需 addon。
商标与版权声明
Section titled “商标与版权声明”本页面和 IGP Godot SDK 未由 Godot Foundation 赞助，也不代表与 Godot Foundation 存在官方关联或背书。
Godot、Godot Engine、Godot 标志及相关商标归 Godot Foundation 所有。相关使用应遵循 Godot Trademark Policy and License。