Windows 正版校验与成就示例

GameMaker（Windows 10 及以上）首期示例：演示正版校验、连接状态、成就解锁与进度上报。

快速开始

1. 从 Release Notes 下载需要使用的发布包。当前文件名是 igp-gamemaker-sdk-0.0.6.zip，解压到任意目录
2. 进入解压后的 samples/gamemaker/windows-auth-achievements/project/
3. 用 GameMaker（2024.2 LTS 及以上）打开 IGP.WindowsAuthAchievements.yyp
4. 按 F5 运行
5. 状态面板应显示当前连接状态与正版校验状态；如本机 IGP 桌面客户端已启动，连接应切换到 connected

提示

不需要手动复制 DLL 或 GML。IGP.GamemakerDesktopBridge.Native.dll 已在 project/datafiles/ 中，运行时 GML 也已作为 script 资源预置在示例工程中。

警告

示例工程中预置的是演示用配置：appId = 10，成就 key 使用 sample.windows.auth.unlock 和 sample.windows.auth.progress。

如果只是确认示例能运行，可直接按上述步骤启动；如需验证自有游戏的授权和成就结果，请先将这些值替换为 IGP 分配的 appId 和后台已配置的成就项。

包含文件

文件	用途
project/IGP.WindowsAuthAchievements.yyp	可直接打开的 GameMaker 工程壳
project/datafiles/IGP.GamemakerDesktopBridge.Native.dll	原生桥 DLL
project/scripts/igp_gms2_windows_runtime/	运行时 GML（官方同步）
project/objects/obj_igp_windows_auth_achievements/	示例对象，演示 Create / Step / Draw 接线
igp_windows_auth_achievements_sample.gml	示例控制器函数
igp_windows_auth_achievements_view.gml	UI 渲染辅助函数
INTEGRATION.md	接入自有工程的步骤
SMOKE-CHECKLIST.md	冒烟验收清单

示例演示什么

• 显示当前正版校验状态：pending / authorized_online / authorized_offline / failed / skipped
• 显示当前连接状态：disconnected / connecting / connected / detached
• 按 F1 触发一次成就解锁
• 按 F2 上报一次 50% 进度
• 显示最近一次结果（success / operation）与最近一次错误（code: message）

进一步

本页主要说明示例包内容。首次接入时，建议按以下顺序阅读：

• GameMaker 安装
• GameMaker Quick Start
• GameMaker 调试

解压后的目录还包含两份面向接入的文档：

• INTEGRATION.md —— 将 bridge 接入自有 GameMaker 工程
• SMOKE-CHECKLIST.md —— 接入完成后的冒烟验收步骤