GameMaker Native Bridge

Native Bridge は、Windows 10 以降の GameMaker 向けに用意されたローカルブリッジライブラリです。

役割分担

• IGP.GamemakerDesktopBridge.Native.dll - 実際のデスクトップ接続、イベントキュー、結果、状態を担当します
• GameMaker 側 runtime スクリプト - DLL の C API を GameMaker 関数呼び出しへ包みます

使い方

GameMaker プロジェクト内では次の流れです。

1. IGP.GamemakerDesktopBridge.Native.dll を Included File として追加する
2. アダプター付属の GML runtime スクリプトを読み込む（windows-auth-achievements サンプルを参照）
3. obj_controller のようなオブジェクトから initialize / update / poll_event を一定周期で呼ぶ

エクスポート関数

関数	役割
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	ブリッジを終了する

拡張ルール

ゲーム認可や機能照会を今後拡張する場合も、追加エクスポートは Native Bridge 層に集約してください。

注意

デスクトップ接続プロトコルの低レベルな詳細、バイト列処理、ハンドシェイク処理を GML 側へ散らさないでください。 GML 側は、ブリッジが公開する関数とイベントだけを消費する形に保ってください。