GameMaker 概览

IGP GameMaker SDK 用于将 GameMaker 游戏接入 IGP 平台的正版校验、实名认证与防沉迷和成就能力。首期聚焦 Windows 上的桌面客户端能力，暂不支持联机房间。

本页仅说明 GameMaker 引擎相关细节。具体功能接入方式，请优先查看“按功能使用”中的对应页面。

功能列表

• 运行时生命周期：初始化、每帧更新、读取状态快照、轮询事件队列、关闭运行时。
• 正版校验：在游戏启动时确认当前玩家是否在 IGP 平台上合法持有这款游戏，返回 authorized_online / authorized_offline 等状态（协议层对应 RequestGameAuthorization）。
• 连接状态：观察与本机 IGP 桌面客户端的连接是否就绪。
• 桌面客户端能力查询：调用能力前可先确认当前桌面客户端暴露了哪些能力。
• 实名认证与防沉迷：读取当前状态、主动刷新状态，并通过 anti_addiction_state_changed 事件接收变化。
• 成就解锁：按 key 解锁成就。
• 成就进度上报：按 key 和增量上报进度。
• 事件队列：通过一个轮询入口接收连接、授权、实名认证与防沉迷、成就、错误和断开事件。

暂不支持

• 联机房间（创建 / 加入 / ready / 实时通信 / state / RPC）
• macOS / Linux / 主机 / 移动端
• 当前 Windows runtime 以外的其他 GameMaker 目标（HTML5 / YYC 等）

接入前提

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

交付形态

一个 zip 包，解压后包含：

• IGP.GamemakerDesktopBridge.Native.dll —— 原生桥接库（Windows）
• GML runtime 脚本 —— 将桥接库的 C API 封装为 GameMaker 函数
• windows-auth-achievements 示例工程 —— 可直接使用 GameMaker 打开
• INTEGRATION.md 与 SMOKE-CHECKLIST.md —— 接入和冒烟验收步骤

当前可用版本与下载链接见 Release Notes。

开始接入

1. 先查看 GameMaker 安装
2. 完成最小验证流程：GameMaker Quick Start
3. 确认基础启动流程：启动与连接
4. 按目标功能继续看：
   • 正版校验
   • 实名认证与防沉迷
   • 成就
5. 做完整检查：联调与测试
6. 如需排查状态和错误：GameMaker 调试
7. 需要查导出函数和底层边界：GameMaker Native Bridge
8. 查看示例目录和演示工程：Windows 正版校验与成就示例

商标与版权声明

本页面和 IGP GameMaker SDK 未由 YoYo Games、GameMaker 或 Opera 赞助，也不代表与上述主体存在官方关联或背书。

GameMaker、GameMaker 标志及相关品牌资产归 YoYo Games / Opera 及其关联方所有。GameMaker 名称、标志和品牌资产的使用应遵循 GameMaker 官方品牌指南。