GameMaker 安装

本页仅说明如何将 SDK 安装到自有 GameMaker 工程。如需先完成最小验证流程，请查看 GameMaker Quick Start。

前置条件

• GameMaker 2024.2 LTS 或更高
• Windows 10 及以上
• 本机安装 IGP 桌面客户端
• IGP 运营分配的 appId

下载并解压发布包

从 Release Notes 下载需要使用的版本。当前 GameMaker SDK 版本是 0.0.6，对应的发布包文件名是 igp-gamemaker-sdk-0.0.6.zip。解压后主要使用以下位置：

• adapters/gamemaker/runtime/igp_gms2_windows_runtime.gml —— 加入自有工程的 runtime 脚本
• adapters/gamemaker/bridge/IGP.GamemakerDesktopBridge.Native.dll —— 加入 Included Files 的原生桥 DLL
• samples/gamemaker/windows-auth-achievements/ —— 官方示例工程和接入说明

安装到自有工程

1. 加入 runtime 脚本

将 adapters/gamemaker/runtime/igp_gms2_windows_runtime.gml 作为 script 资源 加入工程。

建议保留脚本名 igp_gms2_windows_runtime，以便直接复用后续示例代码。

2. 加入原生桥 DLL

将 adapters/gamemaker/bridge/IGP.GamemakerDesktopBridge.Native.dll 作为 Included File 加入工程。

建议放在 datafiles/，以便 GameMaker 运行时将 DLL 一并带到工作目录。

3. 保持默认可选项

常规接入先只准备好 appId 即可。

以下字段属于调试或特殊发行覆盖，首次接入通常不需要修改：

• desktop_auto_attach
• desktop_pipe_endpoint
• desktop_launch_command

默认行为已经是：

• 会自动尝试附着本机桌面客户端
• 留空时会按当前策略自动尝试发现并启动桌面客户端

验证安装

安装完成后，至少确认以下事项：

1. 工程中已包含 igp_gms2_windows_runtime 这个 script 资源
2. Included Files 中已包含 IGP.GamemakerDesktopBridge.Native.dll
3. 按 F5 启动工程时，没有因为脚本缺失或 DLL 缺失直接报错

如需验证完整最小流程，请继续执行 GameMaker Quick Start。