テストプレイ・QA 指示書

対象: テストプレイ参加者・QA担当
前提: Unity エディタ、またはDevelopmentビルドのapkを使用


1. 事前セットアップ(Unityエディタの場合)

メニューバーの Gakugeki → Control Panel を開く。

Auth タブ

テストの目的に合わせて Scenario Profile を選択する(ScenarioProfileの説明を参照)。

設定項目 説明
Scenario Profile テストシナリオの設定セット
Email / Password DebugAccount 使用時のログイン情報
Auto Sign-in 起動時に自動ログインするか

設定後 Save Local Settings を押す(この設定はGitに含まれない)。

Settings タブ

設定項目 説明
VR Mode ONでVRデバイス動作、OFFでPC(マウス・キーボード)動作
Solo Mode ONでマルチプレイ接続をスキップ
XR Device Simulator VR機器なしでヘッドセット入力をシミュレート
Force Start → Start Scene 再生時に指定シーンから起動

2. テストプレイの開始

  1. Control Panel の設定を保存
  2. Unity エディタで 再生ボタン(または apk 起動)
  3. 選択した ScenarioProfile の内容に従ってシナリオが進む

3. ScenarioProfile の説明

Gakugeki Control Panel → Auth タブScenario Profile ドロップダウンで選択する。

DefaultScenarioProfile

通常フロー確認用(本番同等)

項目 設定
認証 Auto(サイレントログイン → 未ログインはタイトル画面)
ワールドイントロ Normal(フル再生)
イベント入場 通常チェックあり
フォトセッション 実データ(Real)
かくれんぼ 有効

本番に近い状態でのE2E確認に使う。


DebugScenarioProfile

開発・機能検証用

項目 設定
認証 DebugAccount(Email/Passwordで強制ログイン)
ワールドイントロ Normal
イベント入場 通常チェックあり
フォトセッション プリセットデータ使用
かくれんぼ 有効

特定アカウントで固定ログインしたい場合や、フォトセッションをプリセットで素早く確認したい場合に使う。
Email と Password を Control Panel の Auth タブに入力してから Save Local Settings を押すこと。


DemoScenarioProfile

デモ・動作確認用(最速起動)

項目 設定
認証 DemoBypass(ログイン画面をスキップ)
ワールドイントロ Short(短縮版)+ 自動入場
イベント入場 入場チェックをバイパス + インベントリをリセット
フォトセッション プリセットデータ使用
かくれんぼ 無効

サインインなしで素早くプレイを開始したい場合に使う。毎回インベントリがリセットされる点に注意。


4. バグを発見したときのバグレポート

問題を発見した瞬間にバグレポートを発行する。

環境 操作
PC / エディタ Bキー を押す
VR実機 左コントローラー Menu ボタン を押す

VR注意: Menu ボタンは SetHeight(床の高さ調整)と共有しています。バグレポートと同時に SetHeight も発火します。

発行が完了すると両手コントローラーが短くバイブします。
Console に [BugReport] 保存完了: ... と表示されたら成功です。

保存されるファイル

%APPDATA%\..\LocalLow\Gakugeki\Crossia\BugReports\
└── yyyy-MM-dd_HH-mm-ss/
    ├── screenshot.png   ← 発行時のスクリーンショット
    ├── logs.jsonl       ← 直近100件のアプリログ
    ├── info.json        ← シーン名・座標・バージョン
    └── input_trace.bin  ← 入力履歴

報告時に添付してほしいもの

  • 上記フォルダをそのまま ZIP 圧縮してチケットに添付
  • 再現手順を一言メモで添える

5. よくある問題

症状 確認箇所
ログインできない Control Panel → Auth タブの Email / Password を確認。DebugAccount の場合は入力必須
タイトル画面から進まない Scenario Profile が DefaultScenarioProfile になっていて認証情報が未設定の可能性。DemoScenarioProfile に切り替えて確認
バグレポートが発行されない Release ビルドでは動作しない。Development Build または Unity エディタで実行しているか確認
VRで頭の高さがずれる Menu ボタン押下で SetHeight が同時発火している。バグレポート後に SetHeight を再調整する