跳转到内容
IGP Developer Docs

GameMaker Native Bridge

Native Bridge 是面向 GameMaker（Windows 10 及以上） 的本地桥接库。

角色

Section titled “角色”
  • IGP.GamemakerDesktopBridge.Native.dll —— 负责真正的桌面连接、事件队列、结果状态
  • GameMaker 侧的 runtime 脚本 —— 将 DLL 的 C API 封装为 GameMaker 的函数调用

使用方式

Section titled “使用方式”

在 GameMaker 工程中：

  1. 将 IGP.GamemakerDesktopBridge.Native.dll 作为 Included File 加入工程
  2. 引入适配层提供的 GML runtime 脚本（见示例工程 windows-auth-achievements）
  3. 在 obj_controller 等对象的 Create / Step 事件中按固定节奏调用 initialize / update / poll_event

导出函数清单

Section titled “导出函数清单”
函数作用
igp_gms2_bridge_initialize初始化桥
igp_gms2_bridge_update每帧驱动（建议放在 Step）
igp_gms2_bridge_poll_event从事件队列读取下一条事件
igp_gms2_bridge_request_game_authorization发起正版校验请求
igp_gms2_bridge_get_desktop_capabilities查询桌面客户端能力集
igp_gms2_bridge_unlock_achievement解锁成就
igp_gms2_bridge_report_achievement_progress上报成就进度
igp_gms2_bridge_get_state_snapshot获取当前状态快照
igp_gms2_bridge_shutdown关闭桥

扩展约定

Section titled “扩展约定”

后续如需扩展正版校验或能力查询，也应继续在 Native Bridge 层增加导出。