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

Unity デバッグ

このページでは Unity Editor 内で実際にどうデバッグするか を扱います。パッケージ導入と最小セットアップは インストール と Quick Start を先に見てください。

Editor 内で IGP SDK をデバッグする代表的なシナリオは 2 つあります。

  • シナリオ A: IGP デスクトップクライアントが提供する機能だけを検証する（ゲーム認可、実績解除、進捗報告）
  • シナリオ B: ホスト型ルームの完全フローを検証する（launch ticket、自動ルーム参加、ready、start、finish、ルームメッセージ、state、RPC、データプレーン）

シングルプレイのゲーム、またはまだマルチプレイヤールームを接続しないゲームでは、通常はシナリオ A だけで十分です。シナリオ B が必要なのは、ルーム、realtime、state、RPC、Mirror Transport、KCP、実行中のマップ変更を接続する場合です。

シナリオ A: デスクトップクライアント機能のみ

Section titled “シナリオ A: デスクトップクライアント機能のみ”

このパスは desktop session を使い、ルームコンテキストには依存しません。ゲーム認可や実績など、ルーム非依存の機能に使います。

Unity Editor 内でデスクトップ機能だけを確認する場合、通常は Desktop Executable Path Debug Override を入力する必要はありません。

このパスが空でも、SDK は選択された環境に対応するデスクトップクライアントを起動し、Unity Editor のプロセスパスと appId をデスクトップ側へ渡します。接続を許可するかどうかはデスクトップ側の SDK デバッグ規則で判定されます。インストール済みゲーム exe の再現やローカル exe 紐付けの調査が必要な場合だけ、このパスを指定してください。その場合は、そのゲームの実際の Windows 実行ファイルパス（例: D:\builds\MyGame\MyGame.exe）を指定し、デスクトップクライアントのパスは指定しません。

この設定はデスクトップクライアントのパスではありません。デスクトップの起動コマンドは SDK Environment から解決されます。PROD は IndieGamesPass、PREVIEW は IndieGamesPass Preview、DEV は IndieSpark を使います。PROD と PREVIEW では、対応する公式の信頼済みデスクトップクライアントだけを起動します。Desktop Launch Command や INDIEGP_DESKTOP_PATH による明示指定は DEV のデバッグ用途です。

シナリオ B: 完全なホスト型ルームフロー

Section titled “シナリオ B: 完全なホスト型ルームフロー”

このパスは hosted session を使い、ルームコンテキストが必要な機能だけに適用します。シングルプレイ接続では、テストルーム作成やマップ選択は不要です。

launch ticket から始まる完全な end-to-end フローを検証したい場合:

1. 先にそのゲームのテストルームへ入る

Section titled “1. 先にそのゲームのテストルームへ入る”
  1. IGP デスクトップクライアントで現在のゲームの SDK 联调 ページを開く
  2. 先にテストルームを作成するか、既存のテストルームへ参加する

2. デスクトップクライアントで Unity 起動パッケージを生成する

Section titled “2. デスクトップクライアントで Unity 起動パッケージを生成する”

IGP デスクトップクライアントの SDK 联调 ページで Unity 启动包 を生成し、JSON をコピーします。

3. 起動パッケージを Runtime Manager に貼り付ける

Section titled “3. 起動パッケージを Runtime Manager に貼り付ける”
  1. IGPRuntimeManager を含むシーンを開く
  2. IGPRuntimeManager を持つオブジェクトを選ぶ
  3. Inspector の Unity Editor 联调 -> Launch Package JSON を探す
  4. JSON 全体を貼り付ける
  5. Apply Launch Package を押す

4. Play mode に入り、ルームへ接続する

Section titled “4. Play mode に入り、ルームへ接続する”
  1. Editor の Play ボタンを押す
  2. Inspector で Connect Current Test Room を押す

この流れは host / guest で対称です。host 側を検証するなら host 用の起動パッケージ、guest 側を検証するなら guest 用の起動パッケージを使ってください。

よくある落とし穴

Section titled “よくある落とし穴”
  • detached しか出ない: デスクトップクライアントにログイン済みで、SDK 联调 が有効で、そのアカウントが現在の appId をデバッグできることを確認してください
  • Connect Current Test Room がずっとつながらない: IGP デスクトップクライアント側で先にそのゲームのテストルームへ入っていない
  • Apply Launch Package 後にルームへ入れない: 起動パッケージが期限切れになっている。デスクトップクライアントに戻って再生成する
  • 両側を起動しても互いに見えない: 両方で同じ起動パッケージを使っている。各プレイヤーは自分用のパッケージを使う必要があります