GameMaker デバッグ

このページでは、現在利用可能な最初の GameMaker 機能 のデバッグだけを扱います。

シナリオ A: 公式サンプルをそのままデバッグする

まず SDK の主要フロー自体が通っているかだけ確認したいなら、リリースパッケージ同梱のサンプルから始めてください。

samples/gamemaker/windows-auth-achievements/project/IGP.WindowsAuthAchievements.yyp を開く
F5 で実行する
画面上では次の項目を重点的に見る
- Initialized
- Connection
- Authorization
- Pending events
- Latest result
- Latest error
- Latest event
F1 で実績解除を実行する
F2 で進捗報告を実行する

サンプルは動くのに自分のゲームでは成功結果が出ない場合は、まずデモ用の appId = 10 やデモ用実績 key のままになっていないか確認してください。

自分のプロジェクトで一番大事なのは UI ではなく、次の呼び出し順が本当に守られているかです。

このどれかが欠けると、状態が「少し動いているように見えるのに本当に準備完了にならない」という挙動になりやすいです。

自分のプロジェクトを切り分けるときは、igp_get_state_snapshot() が返す次の項目を見るのがいちばん有効です。

とくに有用なのは次の 2 つです。

状態変化を待つだけでなく、次の 2 つの確認も有効です。

var result = igp_request_game_authorization(global.igp_app_id);
show_debug_message(json_stringify(result));

この呼び出しで得られるのはリクエスト結果であり、最終状態は引き続き authorization_state を見てください。

var capabilities = igp_get_desktop_capabilities();
show_debug_message(json_stringify(capabilities));

ここで結果が取れないなら、先に実績ロジックではなくデスクトップ接続自体を疑ってください。

APP_ID_REQUIRED: app_id が空、正数ではない、または初期化自体が成立していない
bridge_loaded = false: DLL を Included File に入れていない、または入れたが runtime で読み込みに失敗している
bridge_error に値がある: まずそこを読む。推測よりも直接的な理由が出ていることが多い
Connection が長く connecting のまま: デスクトップクライアントが起動していない、attach に失敗している、または自動起動待ちの途中
Authorization が pending のまま: 認可ロジックの問題よりも、前段の接続が終わっていない、または igp_update() を継続的に呼んでいないケースが多い
F1 / F2 を押しても成功結果が出ない: 実績 key がまだサンプル値のまま、またはバックエンド側にその実績が未設定

次のいずれかに当てはまるなら、業務ロジック側を追い続けるより先に GameMaker インストールに戻ってください。