Windows 認可・実績サンプル

この最初の GameMaker 向けサンプルでは、ゲーム認可、接続状態、実績解除、進捗報告 を確認できます。

クイックスタート（30 秒）

1. リリースノート から使いたいパッケージをダウンロードします。現在のファイル名は 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/ にすでに置かれており、runtime 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/	公式アダプターと同期された 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 デバッグ

展開したディレクトリには、導入向けの文書も 2 つ入っています。

• INTEGRATION.md - ブリッジを自分の GameMaker プロジェクトへ組み込む方法
• SMOKE-CHECKLIST.md - 組み込み後のスモークチェック