コンテンツにスキップ
IGP Developer Docs

GameMaker Quick Start

このページでは 2 つの最小検証ルートを用意しています。

  • 公式サンプルを実行する: リリースパッケージ同梱のサンプルプロジェクトで検証する
  • 自分のプロジェクトへ導入する: 最小の呼び出し順で runtime を組み込む

現在の最初の公開版がカバーしているのは次の範囲です。

  • ゲーム認可
  • 実名認証とアンチアディクション状態
  • 実績解除
  • 実績進捗報告

ルーム、リアルタイム通信、RPC はまだ対象外です。

前提条件

Section titled “前提条件”
  • igp-gamemaker-sdk-0.0.6.zip をすでにダウンロードして展開している
  • ローカル PC に IGP デスクトップクライアント がインストールされ、起動できる
  • 自分のゲーム の成功パスを確認したい場合は、IGP から発行された appId を受け取っている
  • GameMaker runtime は igp_init(...) で初期化します
  • 実名認証とアンチアディクションを検証する場合、バックエンドで「起動ブロック」または「ゲーム内実名認証」を選択済みである。GameMaker は現在、状態の読み取りと更新が中心です

1. 公式サンプルを実行する

Section titled “1. 公式サンプルを実行する”
  1. GameMaker で samples/gamemaker/windows-auth-achievements/project/IGP.WindowsAuthAchievements.yyp を開く
  2. F5 で実行する
  3. まず画面上の次の項目が更新されるか確認する
    • Initialized
    • Connection
    • Authorization
    • Latest result
    • Latest error
    • Latest event
  4. F1 を押して実績解除を 1 回実行する
  5. F2 を押して進捗 50% を 1 回報告する

2. 自分のプロジェクトでの最小呼び出し順

Section titled “2. 自分のプロジェクトでの最小呼び出し順”

Create イベント

Section titled “Create イベント”
global.igp_app_id = YOUR_APP_ID;
global.igp_sdk_enabled = true;


if (global.igp_sdk_enabled && !igp_init(global.igp_app_id, {
    desktop_auto_attach: true
}))
{
    show_debug_message("IGP init failed");
}

Step イベント

Section titled “Step イベント”
if (!global.igp_sdk_enabled)
{
    exit;
}


igp_update();


var evt = igp_poll_event();
while (!is_undefined(evt))
{
    show_debug_message("IGP event: " + string(evt.type));
    evt = igp_poll_event();
}


if (keyboard_check_pressed(vk_f1))
{
    igp_unlock_achievement("YOUR_ACHIEVEMENT_KEY", "", 0, global.igp_app_id);
}


if (keyboard_check_pressed(vk_f2))
{
    igp_report_achievement_progress(
        "YOUR_PROGRESS_ACHIEVEMENT_KEY",
        50,
        "",
        "",
        0,
        global.igp_app_id);
}

Clean Up イベント

Section titled “Clean Up イベント”
igp_shutdown();

3. 最低限の受け入れ条件

Section titled “3. 最低限の受け入れ条件”

デスクトップクライアントが利用可能で、appId が正しく、実績も設定済みである前提で、少なくとも次を確認してください。

  1. igp_init(...) が true を返す
  2. Connection が disconnected のままにならない
  3. Authorization が pending から明確な結果へ進む
    • authorized_online
    • authorized_offline
    • failed
  4. F1 または F2 を押した後、Latest result または Latest event が更新される

4. 次のステップ

Section titled “4. 次のステップ”

Quick Start が完了したら、対象機能に応じて次へ進んでください。