# IGP GameMaker SDK

**Version:** 0.2.14 (bridge SDK gms2-native-bridge/0.0.6)
**Platform:** Windows
**Scope:** 授权验证 + 成就

GameMaker Studio 2 开发者接入 IGP 平台的 SDK 发行包。首期只支持 Windows 平台的授权验证与成就调用。首期明确 **不** 包含：room / realtime / 对战能力。

---

## 我想…

### 🚀 先跑示例（30 秒）

1. GameMaker Studio 2 (2024.2 LTS 及以上) 打开 `samples/gamemaker/windows-auth-achievements/project/IGP.WindowsAuthAchievements.yyp`
2. F5 运行

DLL 和运行时 GML 已在工程里预置，无需手工拷贝。

### 🔧 接入到我自己的工程

看 [`samples/gamemaker/windows-auth-achievements/INTEGRATION.md`](samples/gamemaker/windows-auth-achievements/INTEGRATION.md) 的 **路径 B**。核心步骤：

1. 把 `adapters/gamemaker/runtime/igp_gms2_windows_runtime.gml` 加成 script 资源
2. 把 `adapters/gamemaker/bridge/IGP.GamemakerDesktopBridge.Native.dll` 加成 Included File
3. 在 Create / Step / Clean Up 事件接入 `igp_init` / `igp_update` + `igp_poll_event` / `igp_shutdown`

### 📖 查 API 参考

[`adapters/gamemaker/runtime/API-SHAPE.md`](adapters/gamemaker/runtime/API-SHAPE.md) — 公开函数、事件 payload、错误码。

### 🏗️ 理解架构

[`docs/architecture/gamemaker-windows-boundary.md`](docs/architecture/gamemaker-windows-boundary.md) — GML / 原生桥 / desktop session 的责任划分。

---

## 包内容

```
README.md                              本文件
manifest.json                          版本元信息
adapters/gamemaker/
  README.md                            适配层说明
  runtime/
    README.md                          运行时入口说明
    API-SHAPE.md                       【公开 API 参考】
    igp_gms2_windows_runtime.gml       运行时 GML 脚本（加进自己工程的 script 资源）
  bridge/
    README.md                          原生桥说明
    IGP.GamemakerDesktopBridge.Native.dll   【DLL 构建产物，加进 Included Files】
    IGP.GamemakerDesktopBridge/        桥源码（如需自行构建）
    IGP.GamemakerDesktopBridge.Native/ 原生桥源码
samples/gamemaker/windows-auth-achievements/
  README.md                            示例说明
  INTEGRATION.md                       【接入步骤】
  SMOKE-CHECKLIST.md                   冒烟验收清单
  project/IGP.WindowsAuthAchievements.yyp  【可直接打开的 GMS2 工程】
  …
core/contracts/
  README.md, achievements.md, error-model.md, runtime-events.md
docs/architecture/
  gamemaker-windows-boundary.md
```

本发行是源码快照（GML + C# 源 + 构建好的 DLL），不是 GameMaker 的 compiled export。
