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

Godot 完全プロジェクト

各公開 Godot variant には 2 つの独立した完全プロジェクトがあります。igp-godot-sdk-test.zip は Core、Compliance、GameKit を 1 つの UI で確認し、igp-godot-multiplayer-sample.zip は Arena room、TCP/UDP データプレーン、Godot RPC、自動 E2E を検証します。

SDKTest のダウンロード

Section titled “SDKTest のダウンロード”

Release Notes の同じ行から次をダウンロードします。

  • igp-godot-sdk-test.zip
  • igp-godot-sdk-core.zip
  • igp-godot-sdk-compliance.zip
  • igp-godot-sdk-game-kit.zip

4 ファイルは同じ Godot SDK バージョンと正確な Godot バージョンである必要があります。

実行手順

Section titled “実行手順”
  1. igp-godot-sdk-test.zip を展開して SDKTest/ を取得します。
  2. 一致する Godot バージョンで SDKTest/project.godot をインポートします。
  3. Godot インストール に従い、Core、Compliance、GameKit をテストプロジェクトへ導入します。
  4. Project Settings > Plugins で IGP SDK を有効にします。
  5. Project Settings > Igp > General の igp/general/app_id をテストアプリに変更します。environment も対象環境と一致することを確認し、別アプリの値を残さないでください。
  6. ネイティブライブラリとリソースのインポート完了を待ち、main.tscn を実行します。

公開テンプレートは SDK addon と .godot、.import などの Editor キャッシュを含まないため、初回実行前に SDK パッケージを導入する必要があります。

検証範囲

Section titled “検証範囲”
  • Desktop Session、capability、ゲーム認可、Core runtime イベント。
  • 現在のユーザー、アバター情報、アバターのバイト列。
  • 実績解除、累積進捗、テスト用実績のクリア。
  • 実名 Web セッション、アンチアディクション状態、Compliance イベント、年齢区分、残り時間。
  • Profile、複数プレイヤー情報、ランキングの読み取り・送信、テキスト・データ・画像共有。

初期化と読み取り状態は起動後に実行されます。実績、ランキング送信、共有などの書き込みは、対応ボタンを押した場合だけ実行されます。実際のバックエンド key を使う前に、テストアカウントとアプリ設定を確認してください。

合格条件

Section titled “合格条件”
  • UI に attached、ready、authorization、capability の明確な状態が表示される。
  • Core、Compliance、GameKit セクションが導入済みモジュールを認識する。
  • 読み取り要求が成功または説明可能な業務エラーを返す。
  • 書き込み操作がボタン操作後だけ発生し、結果を表示する。
  • 終了要求、認可変更、エラーがイベントログに表示される。

Multiplayer Sample

Section titled “Multiplayer Sample”

Release Notes の同じ行から igp-godot-multiplayer-sample.zip、Core、Multiplayer addon をダウンロードします。MultiplayerSample/ を展開して 2 つの addon を導入してください。すべて同じ SDK リリースと正確な Godot バージョンである必要があります。

プロジェクト README には完全なディレクトリ説明、手動 2 インスタンス手順、Run-LocalE2E.ps1 のパラメーターがあります。サンプルは Desktop Autoload を有効にしません。自動 E2E は Arena room を直接作成または参加し、プレイヤーごとの descriptor を取得して、host/client 双方の信頼性あり/なしメッセージ送受信を確認します。正式な導入では IGP.create_multiplayer_peer() を使い、Hosted Session から descriptor を取得します。

よくある問題

Section titled “よくある問題”
  • ネイティブライブラリのロード失敗：Godot の正確なバージョンと Windows x86_64 variant を確認します。
  • IGP がない：Core を導入し、IGP SDK を有効にしたことを確認します。
  • 任意モジュールが null：固定の res://addons/... パスを確認し、ゲームを停止して再実行します。
  • APP_ID_REQUIRED：有効な正の整数 igp/general/app_id を設定します。
  • capability がない：デスクトップクライアントのバージョン、ログイン、バックエンドのアプリ設定、環境を確認します。