テストプレイ・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. テストプレイの開始
- Control Panel の設定を保存
- Unity エディタで 再生ボタン(または apk 起動)
- 選択した 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 を再調整する |